StorageFolder.CreateFileAsync Méthode

Définition

Espace de noms:

Windows.Storage

Surcharges

CreateFileAsync(String)	Crée un fichier portant le nom spécifié dans le dossier actif.
CreateFileAsync(String, CreationCollisionOption)	Crée un fichier dans le dossier actif. Cette méthode spécifie également ce qu’il faut faire si un fichier portant le même nom existe déjà dans le dossier actif.

CreateFileAsync(String)

Crée un fichier portant le nom spécifié dans le dossier actif.

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

desiredName

String

Platform::String

winrt::hstring

Nom du nouveau fichier à créer dans le dossier actif.

Retours

IAsyncOperation<StorageFile>

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

Implémente

M:Windows.Storage.IStorageFolder.CreateFileAsync(System.String) M:Windows.Storage.IStorageFolder.CreateFileAsync(Platform::String) M:Windows.Storage.IStorageFolder.CreateFileAsync(winrt::hstring)

Attributs

OverloadAttribute RemoteAsyncAttribute

Exceptions

FileNotFoundException

Le nom de fichier contient des caractères non valides ou le format du nom de fichier est incorrect. Vérifiez la valeur de desiredName.

UnauthorizedAccessException

Vous n’avez pas l’autorisation de créer un fichier dans le dossier actif.

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)

CreateFileAsync(String, CreationCollisionOption)

Crée un fichier dans le dossier actif. Cette méthode spécifie également ce qu’il faut faire si un fichier portant le même nom existe déjà dans le dossier actif.

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

desiredName

String

Platform::String

winrt::hstring

Nom du nouveau fichier à créer dans le dossier actif.

options

CreationCollisionOption

Une des valeurs d’énumération qui détermine comment gérer la collision si un fichier avec le desiredName spécifié existe déjà dans le dossier actif.

Retours

IAsyncOperation<StorageFile>

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

Implémente

M:Windows.Storage.IStorageFolder.CreateFileAsync(System.String,Windows.Storage.CreationCollisionOption) M:Windows.Storage.IStorageFolder.CreateFileAsync(Platform::String,Windows.Storage.CreationCollisionOption) M:Windows.Storage.IStorageFolder.CreateFileAsync(winrt::hstring,Windows.Storage.CreationCollisionOption)

Attributs

OverloadAttribute RemoteAsyncAttribute

Exceptions

Exception

Vous avez spécifié CreationCollisionOption.FailIfExists et un fichier avec le desiredName spécifié existe déjà dans le dossier actif.

FileNotFoundException

Le format du nom de fichier est incorrect. Vérifiez la valeur de desiredName.

UnauthorizedAccessException

Vous n’avez pas l’autorisation de créer un fichier dans le dossier actif.

Voir aussi

• CreateFileAsync(String)