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。 如果您使用檔案選擇器， 則不需要 這項功能。
• 在應用程式資訊清單中，註冊至少一個檔案類型關聯宣告。 此宣告會明確指出應用程式想要在文件庫中存取的檔案類型 (副檔名) 。 應用程式只能列舉、建立或變更在應用程式資訊清單中宣告檔案類型的檔案。 如需詳細資訊，請參閱 處理檔案啟用。 如果您使用檔案選擇器，則 不需要 新增此宣告。

傳回值

若要使用 Documents 文件庫及其內容，請呼叫 StorageFolder 類別的方法和屬性。 如需如何使用檔案和資料夾的一般資訊，請參閱 列舉和查詢檔案和資料夾。