StorageFolder.CreateFileAsync メソッド

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

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

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

function createFileAsync(desiredName)

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

パラメーター

戻り値

このメソッドが完了すると、新しいファイルを表す StorageFile が返されます。

実装

属性

OverloadAttribute RemoteAsyncAttribute

例外

例

次の例では、 CreateFileAsync (String, CreationCollisionOption) オーバーロードメソッドを呼び出して、現在のフォルダーに新しいファイルを作成する方法を示します。 この例では、指定された desiredName を持つファイルが現在のフォルダーに既に存在する場合に、操作が失敗する原因となるオプションの値を明示的に指定します。

using Windows.Storage;
using System.Threading.Tasks;

// Get the app's local folder.
StorageFolder localFolder = Windows.Storage.ApplicationData.Current.LocalFolder;

// Create a new file in the current folder.
// Raise an exception if the file already exists.
string desiredName = "test.txt";
StorageFile newFile = await localFolder.CreateFileAsync(desiredName, CreationCollisionOption.FailIfExists);

IAsyncAction MainPage::ExampleCoroutineAsync()
{
    // Gets the app's local folder.
    Windows::Storage::StorageFolder localFolder{ Windows::Storage::ApplicationData::Current().LocalFolder() };

    // Create a new file in the current folder, and throw an exception if the file already exists.
    std::wstring desiredName{ L"test.txt" };
    StorageFile newFile{ co_await localFolder.CreateFileAsync(desiredName, Windows::Storage::CreationCollisionOption::FailIfExists) };
    // Do something with the new file.
}

//Gets the app's local folder
StorageFolder^ localFolder = ApplicationData::Current->LocalFolder;

//Create a new file in the current folder
// Raise an exception if the file already exists
String^ desiredName = "test.txt";
auto createFileTask = create_task(localFolder->CreateFileAsync(desiredName, Windows::Storage::CreationCollisionOption::FailIfExists));
createFileTask.then([](StorageFile^ newFile)
{
  //Do something with the new file.
 });

注釈

このメソッドは、既定で CreationCollisionOption 列挙体の FailIfExists 値を使用します。 つまり、同じ名前のファイルが現在のフォルダーに既に存在する場合、このメソッドは例外を発生させます。 ファイル名の競合を別の方法で処理する場合は、 CreateFileAsync(String, CreationCollisionOption) メソッドを呼び出します。

ライブラリなどの仮想フォルダー、またはファイルのグループのコンテナーを表すフォルダー ( たとえば、GetFoldersAsync メソッドのいくつかのオーバーロードからの戻り値) にファイルを作成しようとすると、 CreateFileAsync メソッドが失敗する可能性があります。

こちらもご覧ください

• CreateFileAsync(String, CreationCollisionOption)

public:
 virtual IAsyncOperation<StorageFile ^> ^ CreateFileAsync(Platform::String ^ desiredName, CreationCollisionOption options) = CreateFileAsync;

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

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

function createFileAsync(desiredName, options)

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

パラメーター

戻り値

このメソッドが完了すると、新しいファイルを表す StorageFile が返されます。

実装

属性

OverloadAttribute RemoteAsyncAttribute

例外

こちらもご覧ください

• CreateFileAsync(String)