DownloadsFolder クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ダウンロード フォルダー内にファイルとフォルダーを作成します。
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
- 継承
- 属性
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 フォルダーに新しいサブフォルダーを作成し、同じ名前のサブフォルダーがダウンロード フォルダーに既に存在する場合の対処方法を指定します。 |