KnownFolders.DocumentsLibrary 属性

定义

命名空间:

Windows.Storage

获取文档库。 文档库不用于常规用途。

public:
 static property StorageFolder ^ DocumentsLibrary { StorageFolder ^ get(); };

static StorageFolder DocumentsLibrary();

public static StorageFolder DocumentsLibrary { get; }

var storageFolder = KnownFolders.documentsLibrary;

Public Shared ReadOnly Property DocumentsLibrary As StorageFolder

属性值

StorageFolder

文档库。

Windows 要求

应用功能	documentsLibrary

注解

重要

文档库不用于常规用途。 有关详细信息，请参阅应用功能声明。

如果你的应用必须创建和更新只有你的应用使用的文件，请考虑使用应用的 LocalCache 文件夹。 有关应将哪些文件夹用于应用数据的详细信息，请参阅 ApplicationData 类。

或者，让用户使用文件选取器选择文件位置。 有关详细信息，请参阅使用选取器打开文件和文件夹，特别是SuggestedStartLocation可设置为 DocumentsLibrary的 属性。 如果用户从选取器中选择文档库，则 无需 使用此属性，也不需要 documentsLibrary 功能。

先决条件

若要 在不使用 选取器的情况下访问文档库，请执行以下操作。

• 在应用清单中，指定 文档库 功能。 此功能在清单Designer中不可见。 若要添加文档库功能，请在代码视图中打开应用清单并直接编辑 XML。 如果使用文件选取器， 则不需要 此功能。
• 在应用清单中，注册至少一个文件类型关联声明。 此声明显式指示应用要在文档库中访问的文件类型 (扩展名) 。 应用只能枚举、创建或更改具有应用清单中声明的文件类型的文件。 有关详细信息，请参阅 处理文件激活。 如果使用文件选取器，则 无需 添加此声明。

返回值

若要使用文档库及其内容，请调用 StorageFolder 类的方法和属性。 有关如何使用文件和文件夹的一般信息，请参阅 枚举和查询文件和文件夹。