KnownFolders クラス

定義

ユーザー コンテンツを含む共通の場所へのアクセスを提供します。 これには、ユーザーのローカル ライブラリ (ドキュメント、画像、音楽、ビデオなど)、HomeGroup、リムーバブル デバイス、メディア サーバー デバイスのコンテンツが含まれます。

public ref class KnownFolders abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class KnownFolders final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class KnownFolders
Public Class KnownFolders
継承
Object Platform::Object IInspectable KnownFolders
属性

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

ファイル アクセスのサンプルでは、PicturesLibrary プロパティを使用して Pictures ライブラリに新しいファイルを作成する方法を示します。

StorageFolder storageFolder = KnownFolders.PicturesLibrary;
StorageFile file = await storageFolder.CreateFileAsync("sample.png", CreationCollisionOption.ReplaceExisting);
// Do something with the new file.

CreateFileAsync メソッドが完了すると、file変数には新しいファイルを表す StorageFile が含まれます。

注釈

このクラスは静的であり、インスタンス化できません。 次の例に示すように、そのプロパティに直接アクセスします。

  • StorageFolder storageFolder = KnownFolders.PicturesLibrary;

前提条件

このクラスのプロパティで表されるフォルダーとライブラリにアクセスするには、アプリ マニフェストで対応する機能を指定します。 たとえば、 KnownFolders.PicturesLibrary にアクセスするには、アプリ マニフェストで 画像ライブラリ 機能を指定します。 機能の詳細については、「 アプリ機能宣言」を参照してください。

戻り値

KnownFolders クラスのプロパティは 、StorageFolder を返します。 既知のフォルダーとその内容を操作するには、 StorageFolder クラスのメソッドとプロパティを呼び出します。

  • アプリで画像、音楽、ビデオを使用する方法については、「 オーディオ、ビデオ、カメラ」を参照してください。
  • ファイルとフォルダーの使用方法に関する一般的な情報については、「ファイルとフォルダーの 列挙とクエリ」を参照してください。

詳細情報

一般的に使用されるその他の場所にアクセスする方法を次に示します。

アプリがアクセスできる場所の詳細については、「 ファイル アクセス許可」を参照してください。

バージョン履歴

Windows のバージョン SDK バージョン 追加された値
1511 10586 GetFolderForUserAsync
2004 19041 GetFolderAsync
2004 19041 RequestAccessAsync
2004 19041 RequestAccessForUserAsync

プロパティ

AppCaptures

アプリキャプチャフォルダを取得します。

CameraRoll

カメラロールフォルダーを取得します。

DocumentsLibrary

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

HomeGroup

HomeGroupフォルダーを取得します。

MediaServerDevices

メディアサーバー(Digital Living Network Alliance(DLNA))デバイスのフォルダーを取得します。

MusicLibrary

音楽ライブラリを取得します。

Objects3D

オブジェクト3Dフォルダーを取得します。

PicturesLibrary

ピクチャライブラリを取得します。

Playlists

再生リストフォルダーを取得します。

RecordedCalls

録音された呼び出しフォルダーを取得します。

RemovableDevices

リムーバブルデバイスフォルダーを取得します。

SavedPictures

保存済みのピクチャフォルダーを取得します。

VideosLibrary

ビデオライブラリを取得します。

メソッド

GetFolderAsync(KnownFolderId)

指定した folderId のフォルダーを取得します。

GetFolderForUserAsync(User, KnownFolderId)

User の指定された既知のフォルダーを返す静的メソッド。

RequestAccessAsync(KnownFolderId)

フォルダーへのアクセスを制御する機能へのアクセスを要求します。

RequestAccessForUserAsync(User, KnownFolderId)

ユーザーと folderId のアクセスを要求します。

適用対象

こちらもご覧ください