StorageFolder.CreateFileAsync Méthode

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)

Paramètres

Retours

Une fois cette méthode terminée, elle retourne un StorageFile qui représente le nouveau fichier.

Implémente

Attributs

OverloadAttribute RemoteAsyncAttribute

Exceptions

Exemples

L’exemple suivant montre comment créer un fichier dans le dossier actif en appelant la méthode surchargée CreateFileAsync (String, CreationCollisionOption). Cet exemple spécifie explicitement une valeur pour les options qui entraîne l’échec de l’opération si un fichier avec le desiredName spécifié existe déjà dans le dossier actif.

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.
 });

Remarques

Cette méthode utilise la valeur FailIfExists de l’énumération CreationCollisionOption par défaut. Autrement dit, cette méthode déclenche une exception si un fichier portant le même nom existe déjà dans le dossier actif. Si vous souhaitez gérer une collision de nom de fichier d’une autre manière, appelez la méthode CreateFileAsync(String, CreationCollisionOption).

Si vous essayez de créer un fichier dans un dossier virtuel comme une bibliothèque, ou un dossier qui représente un conteneur pour un groupe de fichiers (par exemple, la valeur de retour de certaines surcharges de la méthode GetFoldersAsync ), la méthode CreateFileAsync peut échouer.

Voir aussi

• 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)

Paramètres

Retours

Une fois cette méthode terminée, elle retourne un StorageFile qui représente le nouveau fichier.

Implémente

Attributs

OverloadAttribute RemoteAsyncAttribute

Exceptions

Voir aussi

• CreateFileAsync(String)