StorageFolder.CreateFolderAsync Metode

Definisi

Ruang nama:

Windows.Storage

Overload

CreateFolderAsync(String)	Membuat subfolder baru dengan nama yang ditentukan di folder saat ini.
CreateFolderAsync(String, CreationCollisionOption)	Membuat subfolder baru dengan nama yang ditentukan di folder saat ini. Metode ini juga menentukan apa yang harus dilakukan jika subfolder dengan nama yang sama sudah ada di folder saat ini.

CreateFolderAsync(String)

Membuat subfolder baru dengan nama yang ditentukan di folder saat ini.

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)

Parameter

desiredName

String

Platform::String

winrt::hstring

Nama subfolder baru yang akan dibuat di folder saat ini.

Mengembalikan

IAsyncOperation<StorageFolder>

Ketika metode ini selesai, metode ini mengembalikan StorageFolder yang mewakili subfolder baru.

Penerapan

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

Atribut

OverloadAttribute RemoteAsyncAttribute

Pengecualian

FileNotFoundException

Nama folder berisi karakter yang tidak valid, atau format nama folder salah. Periksa nilai desiredName.

UnauthorizedAccessException

Anda tidak memiliki izin untuk membuat subfolder di folder saat ini.

Contoh

Contoh berikut menunjukkan cara membuat StorageFolder baru di folder saat ini dengan memanggil metode kelebihan beban CreateFolderAsync(String, CreationCollisionOption). Contoh ini secara eksplisit menentukan nilai untuk opsi yang menyebabkan operasi gagal jika folder dengan desiredName yang ditentukan sudah ada di folder saat ini.

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

Keterangan

Metode ini menggunakan nilai FailIfExists dari enumerasi CreationCollisionOption secara default. Artinya, metode ini menimbulkan pengecualian jika subfolder dengan nama yang sama sudah ada di folder saat ini. Jika Anda ingin menangani tabrakan nama folder dengan cara yang berbeda, panggil metode CreateFolderAsync(String, CreationCollisionOption ).

Jika Anda mencoba membuat subfolder di folder virtual seperti pustaka, atau folder yang mewakili kontainer untuk sekelompok file (misalnya, nilai pengembalian dari beberapa kelebihan beban metode GetFoldersAsync ), metode CreateFolderAsync mungkin gagal.

Lihat juga

• CreateFolderAsync(String, CreationCollisionOption)

CreateFolderAsync(String, CreationCollisionOption)

Membuat subfolder baru dengan nama yang ditentukan di folder saat ini. Metode ini juga menentukan apa yang harus dilakukan jika subfolder dengan nama yang sama sudah ada di folder saat ini.

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)

Parameter

desiredName

String

Platform::String

winrt::hstring

Nama subfolder baru yang akan dibuat di folder saat ini.

options

CreationCollisionOption

Salah satu nilai enumerasi yang menentukan cara menangani tabrakan jika subfolder dengan desiredName yang ditentukan sudah ada di folder saat ini.

Mengembalikan

IAsyncOperation<StorageFolder>

Ketika metode ini selesai, metode ini mengembalikan StorageFolder yang mewakili subfolder baru.

Penerapan

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)

Atribut

OverloadAttribute RemoteAsyncAttribute

Pengecualian

FileNotFoundException

Nama folder berisi karakter yang tidak valid, atau format nama folder salah. Periksa nilai desiredName.

UnauthorizedAccessException

Anda tidak memiliki izin untuk membuat subfolder di folder saat ini.

Keterangan

Jika folder dengan desiredName yang ditentukan sudah ada di folder saat ini, CreationCollisionOption yang ditentukan menentukan cara menangani tabrakan.

Lihat juga

• CreateFolderAsync(String)