背水一战 Windows 10 (92) - 文件系统: 读写“最近访问列表”和“未来访问列表”, 管理以及使用索引
作者：webabcd
介绍
背水一战 Windows 10 之 文件系统
- 读写“最近访问列表”和“未来访问列表”
- 管理以及使用索
示例
1、演示如何读写“最近访问列表”和“未来访问列表”
FileSystem/Token/TokenDemo.xaml
<Page
x:Class="Windows10.FileSystem.TokenDemo"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:Windows10.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="10 0 10 10"> <TextBlock Name="lblMsg" Margin="5" /> <Button Name="btnAddToMostRecentlyUsedList" Content="AddToMostRecentlyUsedList" Click="btnAddToMostRecentlyUsedList_Click" Margin="5" /> <Button Name="btnGetMostRecentlyUsedList" Content="GetMostRecentlyUsedList" Click="btnGetMostRecentlyUsedList_Click" Margin="5" /> <Button Name="btnAddToFutureAccessList" Content="AddToFutureAccessList" Click="btnAddToFutureAccessList_Click" Margin="5" /> <Button Name="btnGetFutureAccessList" Content="GetFutureAccessList" Click="btnGetFutureAccessList_Click" Margin="5" /> </StackPanel>
</Grid>
</Page>
FileSystem/Token/TokenDemo.xaml.cs
/*
* 演示如何读写“最近访问列表”和“未来访问列表”
*
* StorageApplicationPermissions - 文件/文件夹的访问列表
* MostRecentlyUsedList - 最近访问列表（实现了 IStorageItemAccessList 接口）
* FutureAccessList - 未来访问列表（实现了 IStorageItemAccessList 接口）
* 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 值，在“列表”查找对应的文件或文件夹
* Remove(string token) - 从“列表”中删除指定 token 值的文件或文件夹
* ContainsItem(string token) - “列表”中是否存储指定 token 值的文件或文件夹
* Clear() - 清除“列表”中的全部文件和文件夹
* CheckAccess(IStorageItem file) - 用于验证 app 是否可在“列表”中访问指定的文件或文件夹
* Entries - 返回 AccessListEntryView 类型的数据，其是 AccessListEntry 类型数据的集合
* MaximumItemsAllowed - “列表”可以保存的文件和文件夹的最大数目
*
* AccessListEntry - 用于封装访问列表中的 StorageFile 或 StorageFolder 的 token 和元数据
* Token - token 值
* Metadata - 元数据
*
*
* 注：
* 1、通常情况下，MostRecentlyUsedList 最大可以保存 25 条数据，FutureAccessList 最大可以保存 1000 条数据。实际情况可通过 IStorageItemAccessList 的 MaximumItemsAllowed 来获取
* 2、这个特性的好处就是：保存到 MostRecentlyUsedList 或 FutureAccessList 中的文件或文件夹，可以直接通过 token 访问到
*/ using System;
using Windows.Storage;
using Windows.Storage.AccessCache;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Navigation;
namespace Windows10.FileSystem
{
public sealed partial class TokenDemo : Page
{
public TokenDemo()
{
this.InitializeComponent();
} protected async override void OnNavigatedTo(NavigationEventArgs e)
{
// 在指定的目录下创建指定的文件
StorageFolder documentsFolder = await KnownFolders.GetFolderForUserAsync(null, KnownFolderId.DocumentsLibrary);
StorageFile storageFile = await documentsFolder.CreateFileAsync("webabcdCacheAccess.txt", CreationCollisionOption.ReplaceExisting); // 在指定的文件中写入指定的文本
string textContent = "I am webabcd";
await FileIO.WriteTextAsync(storageFile, textContent, Windows.Storage.Streams.UnicodeEncoding.Utf8); base.OnNavigatedTo(e);
} private async void btnAddToMostRecentlyUsedList_Click(object sender, RoutedEventArgs e)
{
// 获取文件对象
StorageFolder documentsFolder = await KnownFolders.GetFolderForUserAsync(null, KnownFolderId.DocumentsLibrary);
StorageFile storageFile = await documentsFolder.GetFileAsync("webabcdCacheAccess.txt"); if (storageFile != null && StorageApplicationPermissions.MostRecentlyUsedList.CheckAccess(storageFile))
{
// 将文件添加到“最近访问列表”，并获取对应的 token 值
string token = StorageApplicationPermissions.MostRecentlyUsedList.Add(storageFile, storageFile.Name);
lblMsg.Text = "token：" + token;
lblMsg.Text += Environment.NewLine;
lblMsg.Text += "MostRecentlyUsedList MaximumItemsAllowed: " + StorageApplicationPermissions.MostRecentlyUsedList.MaximumItemsAllowed;
}
} private async void btnGetMostRecentlyUsedList_Click(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 btnAddToFutureAccessList_Click(object sender, RoutedEventArgs e)
{
// 获取文件对象
StorageFolder documentsFolder = await KnownFolders.GetFolderForUserAsync(null, KnownFolderId.DocumentsLibrary);
StorageFile storageFile = await documentsFolder.GetFileAsync("webabcdCacheAccess.txt"); if (storageFile != null && StorageApplicationPermissions.FutureAccessList.CheckAccess(storageFile))
{
// 将文件添加到“未来访问列表”，并获取对应的 token 值
string token = StorageApplicationPermissions.FutureAccessList.Add(storageFile, storageFile.Name);
lblMsg.Text = "token：" + token;
lblMsg.Text += Environment.NewLine;
lblMsg.Text += "FutureAccessList MaximumItemsAllowed: " + StorageApplicationPermissions.FutureAccessList.MaximumItemsAllowed;
}
} private async void btnGetFutureAccessList_Click(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 = "未来访问列表中无数据";
}
}
}
}
2、演示如何管理索引器，以及如何通过索引器获取数据
FileSystem/Indexer/IndexerDemo.xaml
<Page
x:Class="Windows10.FileSystem.Indexer.IndexerDemo"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:Windows10.FileSystem.Indexer"
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"> <Button Name="btnAddToIndexer" Content="添加数据到索引器" Click="btnAddToIndexer_Click" Margin="5" /> <Button Name="btnRetrieveAllItems" Content="获取索引器中的全部数据" Click="btnRetrieveAllItems_Click" Margin="5" /> <Button Name="btnRetrieveMatchingItems" Content="按指定的查询条件获取索引器中的数据" Click="btnRetrieveMatchingItems_Click" Margin="5" /> <ScrollViewer Margin="5" Width="300" Height="400" HorizontalAlignment="Left">
<TextBlock Name="lblMsg"/>
</ScrollViewer> </StackPanel>
</Grid>
</Page>
FileSystem/Indexer/IndexerDemo.xaml.cs
/*
* 演示如何管理索引器，以及如何通过索引器获取数据
*
* ContentIndexer - 索引器管理类
*/ using System;
using System.Collections.Generic;
using Windows.Storage;
using Windows.Storage.Search;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls; namespace Windows10.FileSystem.Indexer
{
public sealed partial class IndexerDemo : Page
{
public IndexerDemo()
{
this.InitializeComponent();
} // 添加数据到索引器
private async void btnAddToIndexer_Click(object sender, RoutedEventArgs e)
{
// 获取一个索引器（可以指定索引器的名字，从而达到对索引器分类的目的）
var indexer = ContentIndexer.GetIndexer();
var content = new IndexableContent();
for (int i = ; i < ; i++)
{
content.Properties[SystemProperties.Title] = "Title: " + i.ToString().PadLeft(, '');
content.Properties[SystemProperties.Keywords] = "Keywords: " + i.ToString().PadLeft(, ''); // 多个用“;”隔开
content.Properties[SystemProperties.Comment] = "Comment: " + i.ToString().PadLeft(, '');
content.Id = "key" + i; // 标识，增加同标识的索引就是更新 // 增加一个索引（另外还有 Update 和 Delete 操作）
await indexer.AddAsync(content);
}
} // 获取索引器中的全部数据
private void btnRetrieveAllItems_Click(object sender, RoutedEventArgs e)
{
ExecuteQueryHelper("*");
} // 按指定的查询条件获取索引器中的数据
private void btnRetrieveMatchingItems_Click(object sender, RoutedEventArgs e)
{
ExecuteQueryHelper("title:\"99\"");
} // 按指定的 AQS 语法从索引器中查询数据
private async void ExecuteQueryHelper(string queryString)
{
lblMsg.Text = "";
var indexer = ContentIndexer.GetIndexer(); // 需要检索的属性
string[] propertyKeys =
{
SystemProperties.Title,
SystemProperties.Keywords,
SystemProperties.Comment
};
// 指定 AQS 字符串（Advanced Query Syntax），参见 http://msdn.microsoft.com/zh-cn/library/windows/apps/aa965711.aspx
var query = indexer.CreateQuery(queryString, propertyKeys); // 执行查询，并获取结果
var documents = await query.GetAsync();
foreach (var document in documents)
{
string itemString = "Key: " + document.Id + "\n";
foreach (var propertyKey in propertyKeys)
{
itemString += propertyKey + ": " + StringifyProperty(document.Properties[propertyKey]) + "\n";
}
lblMsg.Text += itemString + "\n";
}
} // 如果对象是一个字符串集合则用“;”做分隔符，然后以字符串形式输出
public string StringifyProperty(object property)
{
string propertyString = "";
if (property != null)
{
var vectorProperty = property as IEnumerable<string>;
if (vectorProperty != null)
{
foreach (var prop in vectorProperty)
{
propertyString += prop + "; ";
}
}
else
{
propertyString = property.ToString();
}
}
return propertyString;
}
}
}
OK
[源码下载]