KnownFolders クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザー コンテンツを含む共通の場所へのアクセスを提供します。 これには、ユーザーのローカル ライブラリ (ドキュメント、画像、音楽、ビデオなど)、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
- 継承
- 属性
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.Storage.ApplicationData.Current.LocalFolder プロパティからアプリのローカル フォルダーを取得します。
- Windows.ApplicationModel.Package.Current.InstalledLocation プロパティからアプリのインストール フォルダーを取得します。
アプリがアクセスできる場所の詳細については、「 ファイル アクセス許可」を参照してください。
バージョン履歴
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 のアクセスを要求します。 |