DownloadsFolder クラス

定義

名前空間:

Windows.Storage

ダウンロード フォルダー内にファイルとフォルダーを作成します。

public ref class DownloadsFolder abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class DownloadsFolder final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public static class DownloadsFolder

Public Class DownloadsFolder

継承

Object Platform::Object IInspectable DownloadsFolder

属性

ContractVersionAttribute

Windows の要件

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

例

次のように、ダウンロード フォルダーに空のファイルを作成できます。

StorageFile file = await Windows.Storage.DownloadsFolder.CreateFileAsync("sample.txt");
// Process file

createFileAsync が完了したら、file新しいファイルを StorageFile として取得します。

注釈

このクラスは静的であり、インスタンス化することはできません。 代わりに、メソッドを直接呼び出します。

ダウンロード フォルダー内のファイルとフォルダーのアクセス許可

すべてのアプリで、ダウンロード フォルダー内にファイルとフォルダーを作成でき、作成したファイルにアクセスできます。 ただし、アプリは、作成しなかったダウンロード フォルダー内のファイルにアクセスできません。

アプリが [ダウンロード] フォルダーにファイルを作成する場合、ユーザーが他のアプリへのアクセス権を明示的に付与しない限り、他のアプリはファイルに干渉したり、ファイルにアクセスしたりすることはできません。 ユーザーは、ファイル ピッカーからファイルを選択することで、ファイルへのアクセス権を別のアプリに付与できます。 アプリでは、ファイル ピッカーを使用して、作成されなかったダウンロード フォルダー内のファイルにアクセスすることもできます。 ファイル ピッカーを使用してファイルを開く方法の詳細については、「ピッカーを使用して ファイルとフォルダーを開く」を参照してください。

ダウンロード フォルダー内のファイルを作成またはアクセスするための機能は必要ありません。 機能の詳細については、「 アプリ機能の宣言」を参照してください。

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

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1511	10586	CreateFileForUserAsync(User,String)
1511	10586	CreateFileForUserAsync(User,String,CreationCollisionOption)
1511	10586	CreateFolderForUserAsync(User,String)
1511	10586	CreateFolderForUserAsync(User,String,CreationCollisionOption)

メソッド

CreateFileAsync(String)	ダウンロード フォルダー内に新しいファイルを作成します。
CreateFileAsync(String, CreationCollisionOption)	ダウンロード フォルダーに新しいファイルを作成し、同じ名前のファイルがダウンロード フォルダーに既に存在する場合の対処方法を指定します。
CreateFileForUserAsync(User, String)	特定のユーザーのダウンロード フォルダー内に新しいファイルを作成 します。
CreateFileForUserAsync(User, String, CreationCollisionOption)	特定の ユーザーの Downloads フォルダーに新しいファイルを作成し、同じ名前のファイルがダウンロード フォルダーに既に存在する場合の対処方法を指定します。
CreateFolderAsync(String)	ダウンロード フォルダーに新しいサブフォルダーを作成します。
CreateFolderAsync(String, CreationCollisionOption)	Downloads フォルダーに新しいサブフォルダーを作成し、同じ名前のサブフォルダーがダウンロード フォルダーに既に存在する場合の対処方法を指定します。
CreateFolderForUserAsync(User, String)	特定のユーザーの Downloads フォルダー内に新しいサブフォルダーを作成 します。
CreateFolderForUserAsync(User, String, CreationCollisionOption)	特定の ユーザーの Downloads フォルダーに新しいサブフォルダーを作成し、同じ名前のサブフォルダーがダウンロード フォルダーに既に存在する場合の対処方法を指定します。