StorageFolder.CreateFolderAsync Metodo

Definizione

Spazio dei nomi:

Windows.Storage

Overload

CreateFolderAsync(String)	Crea una nuova sottocartella con il nome specificato nella cartella corrente.
CreateFolderAsync(String, CreationCollisionOption)	Crea una nuova sottocartella con il nome specificato nella cartella corrente. Questo metodo specifica anche cosa fare se una sottocartella con lo stesso nome esiste già nella cartella corrente.

CreateFolderAsync(String)

Crea una nuova sottocartella con il nome specificato nella cartella corrente.

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)

Parametri

desiredName

String

Platform::String

winrt::hstring

Nome della nuova sottocartella da creare nella cartella corrente.

Restituisce

IAsyncOperation<StorageFolder>

Al termine di questo metodo, restituisce un oggetto StorageFolder che rappresenta la nuova sottocartella.

Implementazioni

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

Attributi

OverloadAttribute RemoteAsyncAttribute

Eccezioni

FileNotFoundException

Il nome della cartella contiene caratteri non validi o il formato del nome della cartella non è corretto. Controllare il valore di desiredName.

UnauthorizedAccessException

Non si dispone dell'autorizzazione per creare una sottocartella nella cartella corrente.

Esempio

Nell'esempio seguente viene illustrato come creare un nuovo oggetto StorageFolder nella cartella corrente chiamando il metodo overload CreateFolderAsync(String, CreationCollisionOption). In questo esempio viene specificato in modo esplicito un valore per le opzioni che causa l'esito negativo dell'operazione se una cartella con il nome desiderato specificato esiste già nella cartella corrente.

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

Commenti

Questo metodo usa il valore FailIfExists dall'enumerazione CreationCollisionOption per impostazione predefinita. Questo metodo genera un'eccezione se una sottocartella con lo stesso nome esiste già nella cartella corrente. Se si vuole gestire una collisione tra nome cartella in modo diverso, chiamare il metodo CreateFolderAsync(String, CreationCollisionOption).

Se si tenta di creare una sottocartella in una cartella virtuale come una libreria o una cartella che rappresenta un contenitore per un gruppo di file, ad esempio il valore restituito da alcuni overload del metodo GetFoldersAsync, il metodo CreateFolderAsync potrebbe non riuscire.

Vedi anche

• CreateFolderAsync(String, CreationCollisionOption)

CreateFolderAsync(String, CreationCollisionOption)

Crea una nuova sottocartella con il nome specificato nella cartella corrente. Questo metodo specifica anche cosa fare se una sottocartella con lo stesso nome esiste già nella cartella corrente.

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)

Parametri

desiredName

String

Platform::String

winrt::hstring

Nome della nuova sottocartella da creare nella cartella corrente.

options

CreationCollisionOption

Uno dei valori di enumerazione che determina come gestire la collisione se esiste già una sottocartella con il nome desiderato specificato nella cartella corrente.

Restituisce

IAsyncOperation<StorageFolder>

Al termine di questo metodo, restituisce un oggetto StorageFolder che rappresenta la nuova sottocartella.

Implementazioni

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)

Attributi

OverloadAttribute RemoteAsyncAttribute

Eccezioni

FileNotFoundException

Il nome della cartella contiene caratteri non validi o il formato del nome della cartella non è corretto. Controllare il valore di desiredName.

UnauthorizedAccessException

Non si dispone dell'autorizzazione per creare una sottocartella nella cartella corrente.

Commenti

Se una cartella con il nome desiderato specificato esiste già nella cartella corrente, l'opzione CreationCollisionOption specificata determina come gestire la collisione.

Vedi anche

• CreateFolderAsync(String)