DownloadsFolder.CreateFileForUserAsync メソッド

定義

名前空間:

Windows.Storage

オーバーロード

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)

パラメーター

user

User

ファイルが作成される ユーザー 。

desiredName

String

Platform::String

winrt::hstring

作成するファイルの目的の名前。

指定した名前のファイルが既に存在する場合は、同様の一意の名前が使用されます。 たとえば、 desiredName が "MyFileName.jpg" で、その名前のファイルがダウンロード フォルダーに既に存在する場合、代わりに "MyFileName (1).jpg" のような名前で新しいファイルが作成されます。

戻り値

IAsyncOperation<StorageFile>

このメソッドが完了すると、新しいファイルが StorageFile オブジェクトとして返されます。

属性

OverloadAttribute RemoteAsyncAttribute

Windows の要件

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

こちらもご覧ください

• CreateFileForUserAsync(User, String, CreationCollisionOption)
• StorageFile

CreateFileForUserAsync(User, String, CreationCollisionOption)

特定の ユーザーの Downloads フォルダーに新しいファイルを作成し、同じ名前のファイルがダウンロード フォルダーに既に存在する場合の対処方法を指定します。

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)

パラメーター

user

User

ファイルが作成される ユーザー 。

desiredName

String

Platform::String

winrt::hstring

作成するファイルの目的の名前。

現在のフォルダーに、指定した desiredName が既に存在する既存のファイルがある場合、指定された CreationCollisionOption によって、競合に対する Windows の応答方法が決定されます。

option

CreationCollisionOption

desiredName が現在のフォルダー内の既存のファイルの名前と同じである場合の Windows の応答方法を決定する列挙値。

アプリは指定した User の Downloads フォルダー内のファイルにのみアクセスできるため、このパラメーターに OpenIfExists または ReplaceExisting を 指定することはできません。

戻り値

IAsyncOperation<StorageFile>

このメソッドが完了すると、新しいファイルが StorageFile オブジェクトとして返されます。

属性

OverloadAttribute RemoteAsyncAttribute

Windows の要件

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

こちらもご覧ください

• CreateFileForUserAsync(User, String)
• StorageFile