背水一战 Windows 10 (91) - 文件系统: Application Data 中的文件操作, Application Data 中的“设置”操作, 通过 uri 引用 Application Data 中的媒体

作者：webabcd

介绍
背水一战 Windows 10 之文件系统

Application Data 中的文件操作
Application Data 中的“设置”操作
通过 uri 引用 Application Data 中的媒体

示例
1、演示如何在 Application Data（应用程序数据存储）中对文件进行操作
FileSystem/AppData/FileDemo.xaml

<Page
    x:Class="Windows10.FileSystem.AppData.FileDemo"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:Windows10.FileSystem.AppData"
    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="10 0 10 10">

            <TextBlock Name="lblMsg" Margin="5" />

            <Button Name="btnReadWrite" Content="读写 Application Data 中的文件" Click="btnReadWrite_Click" Margin="5" />

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

FileSystem/AppData/FileDemo.xaml.cs

/*
 * 演示如何在 Application Data（应用程序数据存储）中对文件进行操作
 * 
 * 
 * StorageFile - 文件操作类
 *     public static IAsyncOperation<StorageFile> GetFileFromApplicationUriAsync(Uri uri) - 获取本地指定 uri 的文件
 * 
 * 
 * ApplicationData - 操作 Application Data 中数据的类
 *     Current - 返回当前的 ApplicationData 对象
 *     LocalFolder - 返回 StorageFolder 对象。本地存储，永久保存
 *         保存路径：%USERPROFILE%\AppData\Local\Packages\{PackageId}\LocalState
 *         访问协议：ms-appdata:///local/
 *     RoamingFolder - 返回 StorageFolder 对象。漫游存储，同一微软账户同一应用程序在不同设备间会自动同步
 *         保存路径：%USERPROFILE%\AppData\Local\Packages\{PackageId}\RoamingState
 *         访问协议：ms-appdata:///roaming/
 *     TemporaryFolder - 返回 StorageFolder 对象。临时存储，系统在需要的时候可以将其删除
 *         保存路径：%USERPROFILE%\AppData\Local\Packages\{PackageId}\TempState
 *         访问协议：ms-appdata:///temp/
 *     RoamingStorageQuota - 从漫游存储同步到云端的数据的最大大小，只读
 *     ClearAsync() - 删除 Application Data 中的数据
 *     ClearAsync(ApplicationDataLocality locality) - 删除指定存储区的数据据
 *         ApplicationDataLocality.Local, ApplicationDataLocality.Roaming, ApplicationDataLocality.Temporary
 *    
 *     DataChanged - 从服务端向 app 同步漫游数据时所触发的事件
 *     SignalDataChanged() - 强行触发 DataChanged 事件
 */

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

namespace Windows10.FileSystem.AppData
{
    public sealed partial class FileDemo : Page
    {
        StorageFolder _localFolder = ApplicationData.Current.LocalFolder;

        public FileDemo()
        {
            this.InitializeComponent();
        }

        protected override void OnNavigatedTo(NavigationEventArgs e)
        {
            ApplicationData.Current.DataChanged += Current_DataChanged;

            base.OnNavigatedTo(e);
        }

        protected override void OnNavigatedFrom(NavigationEventArgs e)
        {
            ApplicationData.Current.DataChanged -= Current_DataChanged;

            base.OnNavigatedFrom(e);
        }

        //  从服务端向 app 同步漫游数据时
        private async void Current_DataChanged(ApplicationData sender, object args)
        {
            await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
            {
                lblMsg.Text += Environment.NewLine;
                lblMsg.Text += "DataChanged 事件被触发";
            });
        }

        private async void btnReadWrite_Click(object sender, RoutedEventArgs e)
        {
            // 写
            StorageFile fileWrite = await _localFolder.CreateFileAsync(@"webabcdTest\readWriteDemo.txt", CreationCollisionOption.ReplaceExisting);
            await FileIO.WriteTextAsync(fileWrite, "I am webabcd: " + DateTime.Now.ToString());

            // 读
            // StorageFile fileRead = await _localFolder.GetFileAsync(@"webabcdTest\readWriteDemo.txt");
            StorageFile fileRead = await StorageFile.GetFileFromApplicationUriAsync(new Uri("ms-appdata:///local/webabcdTest/readWriteDemo.txt", UriKind.Absolute));
            string textContent = await FileIO.ReadTextAsync(fileRead);
            lblMsg.Text = textContent;

            // 强行触发 DataChanged 事件（仅为演示用，实际项目中不需要）
            ApplicationData.Current.SignalDataChanged();
        }
    }
}

2、演示如何在 Application Data（应用程序数据存储）中对“设置”进行操作
FileSystem/AppData/SettingsDemo.xaml

<Page
    x:Class="Windows10.FileSystem.AppData.SettingsDemo"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:Windows10.FileSystem.AppData"
    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="10 0 10 10">

            <TextBlock Name="lblMsg" Margin="5" />

            <Button Name="btnReadWrite" Content="读写 Settings" Click="btnReadWrite_Click" Margin="5" />

            <Button Name="btnReadWriteWithContainer" Content="分组 Settings" Click="btnReadWriteWithContainer_Click" Margin="5" />

            <Button Name="btnReadWriteWithComposite" Content="父子 Settings" Click="btnReadWriteWithComposite_Click" Margin="5" />

            <Button Name="btnSetVersion0" Content="将 Application Data 的版本号设置为 0" Click="btnSetVersion0_Click" Margin="5" />

            <Button Name="btnSetVersion1" Content="将 Application Data 的版本号设置为 1" Click="btnSetVersion1_Click" Margin="5" />

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

FileSystem/AppData/SettingsDemo.xaml.cs

/*
 * 演示如何在 Application Data（应用程序数据存储）中对“设置”进行操作
 * 
 * ApplicationData - 操作 Application Data 中数据的类
 *     Current - 返回当前的 ApplicationData 对象
 *     LocalSettings - 返回 ApplicationDataContainer 对象。本地存储，永久保存
 *         保存路径：%USERPROFILE%\AppData\Local\Packages\{PackageId}\Settings
 *     RoamingSettings - 返回 ApplicationDataContainer 对象。漫游存储，同一微软账户同一应用程序在不同设备间会自动同步
 *         保存路径：%USERPROFILE%\AppData\Local\Packages\{PackageId}\Settings
 *     Version - 获取当前 Application Data 的版本号，默认值为 0，只读（用于本地“设置”数据的版本控制）
 *     SetVersionAsync() - 指定当前 Application Data 的版本号（用于本地“设置”数据的版本控制）
 * 
 * ApplicationDataContainer - 操作“设置”数据的类
 *     Name - 容器的名称，默认为空
 *     CreateContainer(string name, ApplicationDataCreateDisposition disposition) - 激活一个用于保存“设置”数据的容器，即分组“设置”数据
 *         name - 容器的名称
 *         disposition - 容器的激活方式：Always - 始终激活；Existing - 容器存在才激活
 *     Containers - 容器集合
 *     DeleteContainer() - 删除指定的容器
 *     Values - 保存“设置”数据，一个字典表
 *         其数据可以是一个 ApplicationDataCompositeValue 类型的数据，ApplicationDataCompositeValue 也是一个字典表，这样可将多个“设置”数据放到一个 key 里
 *       
 * 
 * 备注：
 * 当 key 为 HighPriority 时，系统会以最快的速度在多个设备间同步 HighPriority 所对应的数据（支持 ApplicationDataCompositeValue 数据）
 * 示例如下：
 * ApplicationDataContainer.Values["HighPriority"] = "此处的值将会以系统最快的速度在多个设备间同步";
 */

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

namespace Windows10.FileSystem.AppData
{
    public sealed partial class SettingsDemo : Page
    {
        public SettingsDemo()
        {
            this.InitializeComponent();
        }

        // 操作“设置”数据的 demo
        private void btnReadWrite_Click(object sender, RoutedEventArgs e)
        {
            ApplicationDataContainer localSettings = ApplicationData.Current.LocalSettings;

            // 保存“设置”数据
            localSettings.Values["key"] = "I am webabcd";

            // 如果 key 为 HighPriority，则系统将会以最高优先级的速度在多个设备间同步 HighPriority 的值
            // localSettings.Values["HighPriority"] = "I am webabcd";

            // 删除指定的“设置”数据
            // localSettings.Values.Remove("key");

            // 获取“设置”数据
            lblMsg.Text = (string)localSettings.Values["key"];
        }

        // 分组“设置”数据，即在不同的容器中保存不同的数据
        private void btnReadWriteWithContainer_Click(object sender, RoutedEventArgs e)
        {
            // 在 LocalSettings 中激活名为 groupName 的容器
            ApplicationDataContainer container = ApplicationData.Current.LocalSettings;
            ApplicationDataContainer localSettings = container.CreateContainer("groupName", ApplicationDataCreateDisposition.Always);

            // 删除指定的容器
            // container.DeleteContainer("groupName");

            // 在容器内保存“设置”数据
            if (container.Containers.ContainsKey("groupName"))
            {
                container.Containers["groupName"].Values["key"] = "I am webabcd";
            }

            // 从指定的容器内获取“设置”数据
            lblMsg.Text = (string)container.Containers["groupName"].Values["key"];
            lblMsg.Text += Environment.NewLine;
            // 从指定的容器内获取“设置”数据
            lblMsg.Text += (string)localSettings.Values["key"];
        }

        // 父子“设置”数据，即 key 中的数据是一个 ApplicationDataCompositeValue 对象，而 ApplicationDataCompositeValue 也是一个字典表
        private void btnReadWriteWithComposite_Click(object sender, RoutedEventArgs e)
        {
            ApplicationDataContainer localSettings = ApplicationData.Current.LocalSettings;

            // 父子“设置”数据的保存
            ApplicationDataCompositeValue parent1 = new ApplicationDataCompositeValue();
            parent1["child1"] = "abc";
            parent1["child2"] = "xyz";
            localSettings.Values["parent1"] = parent1;

            // 父子“设置”数据的获取
            lblMsg.Text = (string)((ApplicationDataCompositeValue)localSettings.Values["parent1"])["child1"];
            lblMsg.Text += Environment.NewLine;
            lblMsg.Text += (string)((ApplicationDataCompositeValue)localSettings.Values["parent1"])["child2"];
        }


        private async void btnSetVersion0_Click(object sender, RoutedEventArgs e)
        {
            // 将 Application Data 的版本号设置为 0，并执行指定的方法
            await ApplicationData.Current.SetVersionAsync(0, new ApplicationDataSetVersionHandler(SetVersionHandler));
        }

        private async void btnSetVersion1_Click(object sender, RoutedEventArgs e)
        {
            // 将 Application Data 的版本号设置为 1，并执行指定的方法
            await ApplicationData.Current.SetVersionAsync(1, new ApplicationDataSetVersionHandler(SetVersionHandler));
        }

        // 根据当前版本号和将要设置成的版本号，将“设置”数据升级到最新版本
        private async void SetVersionHandler(SetVersionRequest request)
        {
            // 异步操作
            SetVersionDeferral deferral = request.GetDeferral();

            await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
            {
                lblMsg.Text = "CurrentVersion: " + request.CurrentVersion; // 当前版本号
                lblMsg.Text += Environment.NewLine;
                lblMsg.Text += "DesiredVersion: " + request.DesiredVersion; // 将要设置成的版本号
                lblMsg.Text += Environment.NewLine;
                lblMsg.Text += "ApplicationData.Current.Version: " + ApplicationData.Current.Version; // 当前版本号
            });

            // 完成异步操作
            deferral.Complete();
        }
    }
}

3、演示如何通过 uri 的方式引用 Application Data（应用程序数据存储）中的媒体（图片、视频或音频）文件
FileSystem/AppData/MediaReference.xaml

<Page
    x:Class="Windows10.FileSystem.AppData.MediaReference"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:Windows10.FileSystem.AppData"
    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="10 0 10 10">

            <Image Name="imgAppdata" Stretch="None" HorizontalAlignment="Left" Margin="5" />
            <Image Name="imgAppx" Stretch="None" HorizontalAlignment="Left" Margin="5" />

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

FileSystem/AppData/MediaReference.xaml.cs

/*
 * 演示如何通过 uri 的方式引用 Application Data（应用程序数据存储）中的媒体（图片、视频或音频）文件
 * 
 * ApplicationData 中的 LocalFolder 对应 ms-appdata:///local/
 * ApplicationData 中的 RoamingFolder 对应 ms-appdata:///roaming/
 * ApplicationData 中的 TemporaryFolder 对应 ms-appdata:///temp/
 * 
 * StorageFile - 文件操作类
 *     public static IAsyncOperation<StorageFile> GetFileFromApplicationUriAsync(Uri uri) - 获取本地指定 uri 的文件
 */

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

namespace Windows10.FileSystem.AppData
{
    public sealed partial class MediaReference : Page
    {
        public MediaReference()
        {
            this.InitializeComponent();
        }

        protected async override void OnNavigatedTo(NavigationEventArgs e)
        {
            ApplicationData appData = ApplicationData.Current;

            try
            {
                // 将程序包内的文件保存到 ApplicationData 中的 TemporaryFolder
                StorageFile imgFile = await StorageFile.GetFileFromApplicationUriAsync(new Uri("ms-appx:///Assets/Logo.png"));
                await imgFile.CopyAsync(appData.TemporaryFolder, imgFile.Name, NameCollisionOption.ReplaceExisting);
            }
            catch { }

            // 引用 Application Data 内的图片文件并显示
            imgAppdata.Source = new Windows.UI.Xaml.Media.Imaging.BitmapImage(new Uri("ms-appdata:///temp/Logo.png"));
            // 引用程序包内的图片文件并显示
            imgAppx.Source = new Windows.UI.Xaml.Media.Imaging.BitmapImage(new Uri("ms-appx:///Assets/Logo.png"));

            // 也可以在 xaml 这样写
            // <img src="ms-appdata:///temp/Logo.png" />

            base.OnNavigatedTo(e);
        }
    }
}

OK
[源码下载]

posted @ 2018-06-14 09:05 webabcd 阅读(1255) 评论(0) 编辑收藏举报

刷新页面返回顶部

背水一战 Windows 10 (91) - 文件系统: Application Data 中的文件操作, Application Data 中的“设置”操作, 通过 uri 引用 Application Data 中的媒体

公告