StorageFolder.CreateFolderAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
Ketika metode ini selesai, metode ini mengembalikan StorageFolder yang mewakili subfolder baru.
Penerapan
- Atribut
Pengecualian
Nama folder berisi karakter yang tidak valid, atau format nama folder salah. Periksa nilai desiredName.
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
Berlaku untuk
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
Ketika metode ini selesai, metode ini mengembalikan StorageFolder yang mewakili subfolder baru.
Penerapan
- Atribut
Pengecualian
Nama folder berisi karakter yang tidak valid, atau format nama folder salah. Periksa nilai desiredName.
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.