StorageFolder.CreateFolderAsync Méthode

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

Retours

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

Implémente

Attributs

OverloadAttribute RemoteAsyncAttribute

Exceptions

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)

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

Retours

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

Implémente

Attributs

OverloadAttribute RemoteAsyncAttribute

Exceptions

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)