KnownFolders.DocumentsLibrary プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ドキュメントライブラリを取得します。 ドキュメント ライブラリは、一般的な使用を目的としたものではありません。
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
プロパティ値
ドキュメント ライブラリ。
Windows の要件
アプリの機能 |
documentsLibrary
|
注釈
重要
ドキュメント ライブラリは、一般的な使用を目的としたものではありません。 詳しくは、「アプリ機能の宣言」をご覧ください。
アプリのみが使用するファイルをアプリで作成および更新する必要がある場合は、アプリの LocalCache フォルダーの使用を検討してください。 アプリのデータに使用するフォルダーの詳細については、「 ApplicationData クラス」を参照してください。
または、ユーザーがファイル ピッカーを使用してファイルの場所を選択できるようにします。 詳細については、「ピッカーを使用してファイルとフォルダーを開く」、特に SuggestedStartLocation
に設定できるプロパティに関するページをDocumentsLibrary
参照してください。 ユーザーがピッカー内からドキュメント ライブラリを選択した場合、このプロパティを使用する必要も、documentsLibrary 機能も必要ありません。
前提条件
ピッカーを使用 せずに ドキュメント ライブラリにアクセスするには、次の操作を行います。
- アプリ マニフェストで、 ドキュメント ライブラリ 機能を指定します。 この機能は、マニフェスト Designerには表示されません。 ドキュメント ライブラリ機能を追加するには、コード ビューでアプリ マニフェストを開き、XML を直接編集します。 ファイル ピッカーを使用する場合、この機能は必要 ありません 。
- アプリ マニフェストで、少なくとも 1 つのファイルの種類の関連付け宣言を登録します。 この宣言は、アプリがドキュメント ライブラリでアクセスするファイルの種類 (拡張子) を明示的に示します。 アプリは、アプリ マニフェストで宣言されたファイルの種類を持つファイルのみを列挙、作成、または変更できます。 詳細については、「ファイルの アクティブ化を処理する」を参照してください。 ファイル ピッカーを使用する場合は、この宣言を追加する必要 はありません 。
戻り値
ドキュメント ライブラリとその内容を操作するには、 StorageFolder クラスのメソッドとプロパティを呼び出します。 ファイルとフォルダーの使用方法に関する一般的な情報については、「ファイルとフォルダーの 列挙とクエリ」を参照してください。