DownloadsFolder.CreateFileAsync メソッド

定義

名前空間:

Windows.Storage

オーバーロード

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

CreateFileAsync(String)

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

public:
 static IAsyncOperation<StorageFile ^> ^ CreateFileAsync(Platform::String ^ desiredName);

/// [Windows.Foundation.Metadata.Overload("CreateFileAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<StorageFile> CreateFileAsync(winrt::hstring const& desiredName);

[Windows.Foundation.Metadata.Overload("CreateFileAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileAsync(string desiredName);

function createFileAsync(desiredName)

Public Shared Function CreateFileAsync (desiredName As String) As IAsyncOperation(Of StorageFile)

パラメーター

desiredName

String

Platform::String

winrt::hstring

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

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

戻り値

IAsyncOperation<StorageFile>

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

属性

OverloadAttribute RemoteAsyncAttribute

こちらもご覧ください

• CreateFileAsync(String, CreationCollisionOption)

CreateFileAsync(String, CreationCollisionOption)

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

public:
 static IAsyncOperation<StorageFile ^> ^ CreateFileAsync(Platform::String ^ desiredName, CreationCollisionOption option);

/// [Windows.Foundation.Metadata.Overload("CreateFileWithCollisionOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<StorageFile> CreateFileAsync(winrt::hstring const& desiredName, CreationCollisionOption const& option);

[Windows.Foundation.Metadata.Overload("CreateFileWithCollisionOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileAsync(string desiredName, CreationCollisionOption option);

function createFileAsync(desiredName, option)

Public Shared Function CreateFileAsync (desiredName As String, option As CreationCollisionOption) As IAsyncOperation(Of StorageFile)

パラメーター

desiredName

String

Platform::String

winrt::hstring

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

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

option

CreationCollisionOption

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

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

戻り値

IAsyncOperation<StorageFile>

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

属性

OverloadAttribute RemoteAsyncAttribute

こちらもご覧ください

• CreateFileAsync(String)