次の方法で共有


DownloadsFolder.CreateFileForUserAsync メソッド

定義

オーバーロード

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" のような名前で新しいファイルが作成されます。

戻り値

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

属性

Windows の要件

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

こちらもご覧ください

適用対象

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 を 指定することはできません。

戻り値

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

属性

Windows の要件

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

こちらもご覧ください

適用対象