StorageFolder.CreateFolderAsync Méthode

Définition

Espace de noms:

Windows.Storage

Surcharges

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

CreateFolderAsync(String)

Crée un sous-dossier avec le nom spécifié dans le dossier actif.

public:
 virtual IAsyncOperation<StorageFolder ^> ^ CreateFolderAsync(Platform::String ^ desiredName) = CreateFolderAsync;

/// [Windows.Foundation.Metadata.Overload("CreateFolderAsyncOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageFolder> CreateFolderAsync(winrt::hstring const& desiredName);

[Windows.Foundation.Metadata.Overload("CreateFolderAsyncOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageFolder> CreateFolderAsync(string desiredName);

function createFolderAsync(desiredName)

Public Function CreateFolderAsync (desiredName As String) As IAsyncOperation(Of StorageFolder)

Paramètres

desiredName

String

Platform::String

winrt::hstring

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

Retours

IAsyncOperation<StorageFolder>

Une fois cette méthode terminée, elle retourne un StorageFolder qui représente le nouveau sous-dossier.

Implémente

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

Attributs

OverloadAttribute RemoteAsyncAttribute

Exceptions

FileNotFoundException

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

UnauthorizedAccessException

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

Exemples

L’exemple suivant montre comment créer un StorageFolder dans le dossier actif en appelant la méthode surchargée CreateFolderAsync(String, CreationCollisionOption). Cet exemple spécifie explicitement une valeur pour les options qui entraîne l’échec de l’opération si un dossier 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 subfolder in the current folder.
// Raise an exception if the folder already exists.
string desiredName = "Subfolder";
StorageFolder newFolder =
    await localFolder.CreateFolderAsync(desiredName, CreationCollisionOption.FailIfExists);

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

    // Create a new subfolder in the current folder.
    // Throw an exception if it already exists.
    std::wstring desiredName{ L"Subfolder" };
    Windows::Storage::StorageFolder folder{ co_await localFolder.CreateFolderAsync(desiredName, Windows::Storage::CreationCollisionOption::FailIfExists) };

    // Do something with folder.
}

//Get app's local folder
StorageFolder^ localFolder = Windows::Storage::ApplicationData::Current->LocalFolder;

// Create a new subfolder in the current folder
// Raise an exception if it already exists
String^ desiredName = "Subfolder";
create_task(localFolder->CreateFolderAsync(desiredName,Windows::Storage::CreationCollisionOption::FailIfExists)).then([](StorageFolder^ folder)
{
   //Do something with folder
});

Remarques

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

Si vous essayez de créer un sous-dossier 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 CreateFolderAsync peut échouer.

Voir aussi

• CreateFolderAsync(String, CreationCollisionOption)

CreateFolderAsync(String, CreationCollisionOption)

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

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

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

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

function createFolderAsync(desiredName, options)

Public Function CreateFolderAsync (desiredName As String, options As CreationCollisionOption) As IAsyncOperation(Of StorageFolder)

Paramètres

desiredName

String

Platform::String

winrt::hstring

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

options

CreationCollisionOption

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

Retours

IAsyncOperation<StorageFolder>

Une fois cette méthode terminée, elle retourne un StorageFolder qui représente le nouveau sous-dossier.

Implémente

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

Attributs

OverloadAttribute RemoteAsyncAttribute

Exceptions

FileNotFoundException

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

UnauthorizedAccessException

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

Remarques

Si un dossier avec le desiredName spécifié existe déjà dans le dossier actif, l’option CreationCollisionOption spécifiée détermine comment gérer la collision.

Voir aussi

• CreateFolderAsync(String)