KnownFolders.DocumentsLibrary プロパティ

定義

ドキュメントライブラリを取得します。 ドキュメント ライブラリは、一般的な使用を目的としたものではありません。

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 クラスのメソッドとプロパティを呼び出します。 ファイルとフォルダーの使用方法に関する一般的な情報については、「ファイルとフォルダーの 列挙とクエリ」を参照してください。

適用対象