重新想象 Windows 8 Store Apps (23) - 文件系统: 文本的读写, 二进制的读写, 流的读写, 最近访问列表和未来访问列表

原文:重新想象 Windows 8 Store Apps (23) - 文件系统: 文本的读写, 二进制的读写, 流的读写, 最近访问列表和未来访问列表

[源码下载]

重新想象 Windows 8 Store Apps (23) - 文件系统: 文本的读写, 二进制的读写, 流的读写, 最近访问列表和未来访问列表

作者：webabcd

介绍
重新想象 Windows 8 Store Apps 之 文件系统

• 演示如何读写文本数据
• 演示如何读写二进制数据
• 演示如何读写流数据
• 演示如何读写“最近访问列表”和“未来访问列表”

示例
1、演示如何读写文本数据
FileSystem/ReadWriteText.xaml.cs

/*
 * 演示如何读写文本数据
 * 注：如果需要读写某扩展名的文件，需要在 Package.appxmanifest 增加“文件类型关联”声明，并做相应的配置
 *
 * StorageFolder - 文件夹操作类
 *     获取文件夹相关属性、重命名、Create...、Get...等
 *
 * StorageFile - 文件操作类
 *     获取文件相关属性、重命名、Create...、Get...、Copy...、Move...、Delete...、Open...、Replace...等
 *
 * FileIO - 用于读写 IStorageFile 对象的帮助类
 *     WriteTextAsync() - 将指定的文本数据写入到指定的文件
 *     AppendTextAsync() - 将指定的文本数据追加到指定的文件
 *     WriteLinesAsync() - 将指定的多行文本数据写入到指定的文件
 *     AppendLinesAsync() - 将指定的多行文本数据追加到指定的文件
 *     ReadTextAsync() - 获取指定的文件中的文本数据
 *     ReadLinesAsync() - 获取指定的文件中的文本数据，返回的是一行一行的数据
 *
 * 注：WinRT 中的关于存储操作的相关类都在 Windows.Storage 命名空间内
 */

using System;
using Windows.Storage;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;

namespace XamlDemo.FileSystem
{
    public sealed partial class ReadWriteText : Page
    {
        public ReadWriteText()
        {
            this.InitializeComponent();
        }
        private async void btnWriteText_Click_1(object sender, RoutedEventArgs e)
        {
            // 在指定的目录下创建指定的文件
            StorageFolder storageFolder = KnownFolders.DocumentsLibrary;
            StorageFile storageFile = await storageFolder.CreateFileAsync("webabcdText.txt", CreationCollisionOption.ReplaceExisting);

            // 在指定的文件中写入指定的文本
            string textContent = "I am webabcd";
            await FileIO.WriteTextAsync(storageFile, textContent, Windows.Storage.Streams.UnicodeEncoding.Utf8);

            lblMsg.Text = "写入成功";
        }

        private async void btnReadText_Click_1(object sender, RoutedEventArgs e)
        {
            // 在指定的目录下获取指定的文件
            StorageFolder storageFolder = KnownFolders.DocumentsLibrary;
            StorageFile storageFile = await storageFolder.GetFileAsync("webabcdText.txt");

            if (storageFile != null)
            {
                // 获取指定的文件中的文本内容
                string textContent = await FileIO.ReadTextAsync(storageFile, Windows.Storage.Streams.UnicodeEncoding.Utf8);
                lblMsg.Text = "读取结果：" + textContent;
            }
        }
    }
}

2、演示如何读写二进制数据
FileSystem/ReadWriteBinary.xaml.cs

/*
 * 演示如何读写二进制数据
 * 注：如果需要读写某扩展名的文件，需要在 Package.appxmanifest 增加“文件类型关联”声明，并做相应的配置
 *
 * StorageFolder - 文件夹操作类
 *     获取文件夹相关属性、重命名、Create...、Get...等
 *
 * StorageFile - 文件操作类
 *     获取文件相关属性、重命名、Create...、Get...、Copy...、Move...、Delete...、Open...、Replace...等
 *
 * FileIO - 用于读写 IStorageFile 对象的帮助类
 *     WriteBufferAsync() - 将指定的二进制数据写入指定的文件
 *     ReadBufferAsync() - 获取指定的文件中的二进制数据
 *
 * IBuffer - WinRT 中的字节数组
 *
 * 注：WinRT 中的关于存储操作的相关类都在 Windows.Storage 命名空间内
 */

using System;
using Windows.Storage;
using Windows.Storage.Streams;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;

namespace XamlDemo.FileSystem
{
    public sealed partial class ReadWriteBinary : Page
    {
        public ReadWriteBinary()
        {
            this.InitializeComponent();
        }

        private async void btnWriteBinary_Click_1(object sender, RoutedEventArgs e)
        {
            // 在指定的目录下创建指定的文件
            StorageFolder storageFolder = KnownFolders.DocumentsLibrary;
            StorageFile storageFile = await storageFolder.CreateFileAsync("webabcdBinary.txt", CreationCollisionOption.ReplaceExisting);

            // 将字符串转换成二进制数据，并保存到指定文件
            string textContent = "I am webabcd";
            IBuffer buffer = ConverterHelper.String2Buffer(textContent);
            await FileIO.WriteBufferAsync(storageFile, buffer);

            lblMsg.Text = "写入成功";
        }

        private async void btnReadBinary_Click_1(object sender, RoutedEventArgs e)
        {
            // 在指定的目录下获取指定的文件
            StorageFolder storageFolder = KnownFolders.DocumentsLibrary;
            StorageFile storageFile = await storageFolder.GetFileAsync("webabcdBinary.txt");

            if (storageFile != null)
            {
                // 获取指定文件中的二进制数据，将其转换成字符串并显示
                IBuffer buffer = await FileIO.ReadBufferAsync(storageFile);
                string textContent = ConverterHelper.Buffer2String(buffer);

                lblMsg.Text = "读取结果：" + textContent;
            }
        }
    }
}

3、演示如何读写流数据
FileSystem/ReadWriteStream.xaml.cs

/*
 * 演示如何读写流数据
 * 注：如果需要读写某扩展名的文件，需要在 Package.appxmanifest 增加“文件类型关联”声明，并做相应的配置
 *
 * StorageFolder - 文件夹操作类
 *     获取文件夹相关属性、重命名、Create...、Get...等
 *
 * StorageFile - 文件操作类
 *     获取文件相关属性、重命名、Create...、Get...、Copy...、Move...、Delete...、Open...、Replace...等
 *
 * IBuffer - WinRT 中的字节数组
 *
 * IInputStream - 需要读取的流
 * IOutputStream - 需要写入的流
 * IRandomAccessStream - 需要读取、写入的流，其继承自 IInputStream 和 IOutputStream
 *
 * DataReader - 从数据流中读取数据，即从 IInputStream 读取
 *     LoadAsync() - 从数据流中加载指定长度的数据到缓冲区
 *     ReadInt32(), ReadByte(), ReadString() 等 - 从缓冲区中读取数据
 * DataWriter - 将数据写入数据流，即写入 IOutputStream
 *     WriteInt32(), WriteByte(), WriteString() 等 - 将数据写入缓冲区
 *     StoreAsync() - 将缓冲区中的数据保存到数据流
 *
 * StorageStreamTransaction - 用于写数据流到文件的类（具体用法，详见下面的代码）
 *     Stream - 数据流（只读）
 *     CommitAsync - 将数据流保存到文件
 *
 * 注：WinRT 中的关于存储操作的相关类都在 Windows.Storage 命名空间内
 */

using System;
using Windows.Storage;
using Windows.Storage.Streams;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;

namespace XamlDemo.FileSystem
{
    public sealed partial class ReadWriteStream : Page
    {
        public ReadWriteStream()
        {
            this.InitializeComponent();
        }

        private async void btnWriteStream_Click_1(object sender, RoutedEventArgs e)
        {
            // 在指定的目录下创建指定的文件
            StorageFolder storageFolder = KnownFolders.DocumentsLibrary;
            StorageFile storageFile = await storageFolder.CreateFileAsync("webabcdStream.txt", CreationCollisionOption.ReplaceExisting);

            string textContent = "I am webabcd";

            using (StorageStreamTransaction transaction = await storageFile.OpenTransactedWriteAsync())
            {
                using (DataWriter dataWriter = new DataWriter(transaction.Stream))
                {
                    // 将字符串写入数据流，然后将数据流保存到文件
                    dataWriter.WriteString(textContent);
                    transaction.Stream.Size = await dataWriter.StoreAsync();
                    await transaction.CommitAsync();

                    lblMsg.Text = "写入成功";
                }
            }
        }

        private async void btnReadStream_Click_1(object sender, RoutedEventArgs e)
        {
            // 在指定的目录下获取指定的文件
            StorageFolder storageFolder = KnownFolders.DocumentsLibrary;
            StorageFile storageFile = await storageFolder.GetFileAsync("webabcdStream.txt");

            if (storageFile != null)
            {
                using (IRandomAccessStream randomStream = await storageFile.OpenAsync(FileAccessMode.Read))
                {
                    using (DataReader dataReader = new DataReader(randomStream))
                    {
                        ulong size = randomStream.Size;
                        if (size <= uint.MaxValue)
                        {
                            // 获取数据流，从中读取字符串值并显示
                            uint numBytesLoaded = await dataReader.LoadAsync((uint)size);
                            string fileContent = dataReader.ReadString(numBytesLoaded);

                            lblMsg.Text = "读取结果：" + fileContent;
                        }
                    }
                }
            }
        }
    }
}

4、演示如何读写“最近访问列表”和“未来访问列表”
FileSystem/CacheAccess.xaml

<Page
    x:Class="XamlDemo.FileSystem.CacheAccess"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:XamlDemo.FileSystem"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    mc:Ignorable="d">

    <Grid Background="Transparent">
        <StackPanel Margin="120 0 0 0">

            <TextBlock Name="lblMsg" FontSize="14.667" />

            <Button Name="btnAddToMostRecentlyUsedList" Content="AddToMostRecentlyUsedList" Click="btnAddToMostRecentlyUsedList_Click_1" Margin="0 10 0 0" />

            <Button Name="btnGetMostRecentlyUsedList" Content="GetMostRecentlyUsedList" Click="btnGetMostRecentlyUsedList_Click_1" Margin="0 10 0 0" />

            <Button Name="btnAddToFutureAccessList" Content="AddToFutureAccessList" Click="btnAddToFutureAccessList_Click_1" Margin="0 10 0 0" />

            <Button Name="btnGetFutureAccessList" Content="GetFutureAccessList" Click="btnGetFutureAccessList_Click_1" Margin="0 10 0 0" />

        </StackPanel>
    </Grid>
</Page>

FileSystem/CacheAccess.xaml.cs

/*
 * 演示如何读写“最近访问列表”和“未来访问列表”
 * 注：如果需要读写某扩展名的文件，需要在 Package.appxmanifest 增加“文件类型关联”声明，并做相应的配置
 *
 * StorageFolder - 文件夹操作类
 *     获取文件夹相关属性、重命名、Create...、Get...等
 *
 * StorageFile - 文件操作类
 *     获取文件相关属性、重命名、Create...、Get...、Copy...、Move...、Delete...、Open...、Replace...等
 *
 * StorageApplicationPermissions - 文件/文件夹的访问列表
 *     MostRecentlyUsedList - 最近访问列表（实现了 IStorageItemAccessList 接口）
 *         Add(IStorageItem file, string metadata) - 添加文件或文件夹到“最近访问列表”，返回 token 值（一个字符串类型的标识），通过此值可以方便地检索到对应的文件或文件夹
 *             file - 需要添加到列表的文件或文件夹
 *             metadata - 自定义元数据，相当于上下文
 *         AddOrReplace(string token, IStorageItem file, string metadata) - 添加文件或文件夹到“最近访问列表”，如果已存在则替换
 *         GetFileAsync(string token) - 根据 token 值，在“最近访问列表”查找对应的文件
 *         GetFolderAsync(string token) - 根据 token 值，在“最近访问列表”查找对应的文件夹
 *         GetItemAsync(string token) - 根据 token 值，在“最近访问列表”查找对应的文件或文件夹
 *         Entries - 返回 AccessListEntryView 类型的数据，其是 AccessListEntry 类型数据的集合
 *     FutureAccessList - 未来访问列表（实现了 IStorageItemAccessList 接口）
 *         基本用法同“MostRecentlyUsedList”
 *
 * AccessListEntry - 用于封装访问列表中的 StorageFile 或 StorageFolder 的 token 和元数据
 *     Token - token 值
 *     Metadata - 元数据
 *
 * 注：WinRT 中的关于存储操作的相关类都在 Windows.Storage 命名空间内
 */

using System;
using Windows.Storage;
using Windows.Storage.AccessCache;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Navigation;

namespace XamlDemo.FileSystem
{
    public sealed partial class CacheAccess : Page
    {
        public CacheAccess()
        {
            this.InitializeComponent();
        }

        protected async override void OnNavigatedTo(NavigationEventArgs e)
        {
            // 在指定的目录下创建指定的文件
            StorageFolder storageFolder = KnownFolders.DocumentsLibrary;
            StorageFile storageFile = await storageFolder.CreateFileAsync("webabcdCacheAccess.txt", CreationCollisionOption.ReplaceExisting);

            // 在指定的文件中写入指定的文本
            string textContent = "I am webabcd";
            await FileIO.WriteTextAsync(storageFile, textContent, Windows.Storage.Streams.UnicodeEncoding.Utf8);
        }

        private async void btnAddToMostRecentlyUsedList_Click_1(object sender, RoutedEventArgs e)
        {
            // 获取文件对象
            StorageFolder storageFolder = KnownFolders.DocumentsLibrary;
            StorageFile storageFile = await storageFolder.GetFileAsync("webabcdCacheAccess.txt");

            if (storageFile != null)
            {
                // 将文件添加到“最近访问列表”，并获取对应的 token 值
                string token = StorageApplicationPermissions.MostRecentlyUsedList.Add(storageFile, storageFile.Name);
                lblMsg.Text = "token：" + token;
            }
        }

        private async void btnAddToFutureAccessList_Click_1(object sender, RoutedEventArgs e)
        {
            // 获取文件对象
            StorageFolder storageFolder = KnownFolders.DocumentsLibrary;
            StorageFile storageFile = await storageFolder.GetFileAsync("webabcdCacheAccess.txt");

            if (storageFile != null)
            {
                // 将文件添加到“未来访问列表”，并获取对应的 token 值
                string token = StorageApplicationPermissions.FutureAccessList.Add(storageFile, storageFile.Name);
                lblMsg.Text = "token：" + token;
            }
        }

        private async void btnGetMostRecentlyUsedList_Click_1(object sender, RoutedEventArgs e)
        {
            AccessListEntryView entries = StorageApplicationPermissions.MostRecentlyUsedList.Entries;
            if (entries.Count > )
            {
                // 通过 token 值，从“最近访问列表”中获取文件对象
                AccessListEntry entry = entries[];
                StorageFile storageFile = await StorageApplicationPermissions.MostRecentlyUsedList.GetFileAsync(entry.Token);

                string textContent = await FileIO.ReadTextAsync(storageFile);
                lblMsg.Text = "MostRecentlyUsedList 的第一个文件的文本内容：" + textContent;
            }
            else
            {
                lblMsg.Text = "最近访问列表中无数据";
            }
        }

        private async void btnGetFutureAccessList_Click_1(object sender, RoutedEventArgs e)
        {
            AccessListEntryView entries = StorageApplicationPermissions.FutureAccessList.Entries;
            if (entries.Count > )
            {
                // 通过 token 值，从“未来访问列表”中获取文件对象
                AccessListEntry entry = entries[];
                StorageFile storageFile = await StorageApplicationPermissions.FutureAccessList.GetFileAsync(entry.Token);

                string textContent = await FileIO.ReadTextAsync(storageFile);
                lblMsg.Text = "FutureAccessList 的第一个文件的文本内容：" + textContent;
            }
            else
            {
                lblMsg.Text = "未来访问列表中无数据";
            }
        }
    }
}

OK
[源码下载]