DownloadsFolder.CreateFileForUserAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| CreateFileForUserAsync(User, String) |
特定のユーザーのダウンロード フォルダー内に新しいファイルを作成 します。 |
| CreateFileForUserAsync(User, String, CreationCollisionOption) |
特定の ユーザーの Downloads フォルダーに新しいファイルを作成し、同じ名前のファイルがダウンロード フォルダーに既に存在する場合の対処方法を指定します。 |
CreateFileForUserAsync(User, String)
public:
static IAsyncOperation<StorageFile ^> ^ CreateFileForUserAsync(User ^ user, Platform::String ^ desiredName);/// [Windows.Foundation.Metadata.Overload("CreateFileForUserAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<StorageFile> CreateFileForUserAsync(User const& user, winrt::hstring const& desiredName);[Windows.Foundation.Metadata.Overload("CreateFileForUserAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileForUserAsync(User user, string desiredName);function createFileForUserAsync(user, desiredName)Public Shared Function CreateFileForUserAsync (user As User, desiredName As String) As IAsyncOperation(Of StorageFile)パラメーター
- desiredName
-
String
Platform::String
winrt::hstring
作成するファイルの目的の名前。
指定した名前のファイルが既に存在する場合は、同様の一意の名前が使用されます。 たとえば、 desiredName が "MyFileName.jpg" で、その名前のファイルがダウンロード フォルダーに既に存在する場合、代わりに "MyFileName (1).jpg" のような名前で新しいファイルが作成されます。
戻り値
このメソッドが完了すると、新しいファイルが StorageFile オブジェクトとして返されます。
- 属性
Windows の要件
| デバイス ファミリ |
Windows 10 (10.0.10586.0 で導入)
|
| API contract |
Windows.Foundation.UniversalApiContract (v2.0 で導入)
|
こちらもご覧ください
適用対象
CreateFileForUserAsync(User, String, CreationCollisionOption)
public:
static IAsyncOperation<StorageFile ^> ^ CreateFileForUserAsync(User ^ user, Platform::String ^ desiredName, CreationCollisionOption option);/// [Windows.Foundation.Metadata.Overload("CreateFileForUserWithCollisionOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<StorageFile> CreateFileForUserAsync(User const& user, winrt::hstring const& desiredName, CreationCollisionOption const& option);[Windows.Foundation.Metadata.Overload("CreateFileForUserWithCollisionOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileForUserAsync(User user, string desiredName, CreationCollisionOption option);function createFileForUserAsync(user, desiredName, option)Public Shared Function CreateFileForUserAsync (user As User, desiredName As String, option As CreationCollisionOption) As IAsyncOperation(Of StorageFile)パラメーター
- desiredName
-
String
Platform::String
winrt::hstring
作成するファイルの目的の名前。
現在のフォルダーに、指定した desiredName が既に存在する既存のファイルがある場合、指定された CreationCollisionOption によって、競合に対する Windows の応答方法が決定されます。
- option
- CreationCollisionOption
desiredName が現在のフォルダー内の既存のファイルの名前と同じである場合の Windows の応答方法を決定する列挙値。
アプリは指定した User の Downloads フォルダー内のファイルにのみアクセスできるため、このパラメーターに OpenIfExists または ReplaceExisting を 指定することはできません。
戻り値
このメソッドが完了すると、新しいファイルが StorageFile オブジェクトとして返されます。
- 属性
Windows の要件
| デバイス ファミリ |
Windows 10 (10.0.10586.0 で導入)
|
| API contract |
Windows.Foundation.UniversalApiContract (v2.0 で導入)
|