KnownFolders クラス

リファレンス

定義

名前空間:: Windows.Storage

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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

継承: Object Platform::Object IInspectable KnownFolders

属性: ContractVersionAttribute MarshalingBehaviorAttribute

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 のアクセスを要求します。

適用対象