StorageFolder.CreateFolderAsync 方法

  • 參考

定義

命名空間:
Windows.Storage

多載

CreateFolderAsync(String)

使用目前資料夾中的指定名稱建立新的子資料夾。
CreateFolderAsync(String, CreationCollisionOption)

使用目前資料夾中的指定名稱建立新的子資料夾。 如果目前資料夾中已有相同名稱的子資料夾，這個方法也會指定該怎麼做。

CreateFolderAsync(String)

編輯

使用目前資料夾中的指定名稱建立新的子資料夾。

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)

參數

desiredName
String

Platform::String

winrt::hstring

目前資料夾中要建立的新子資料夾名稱。

傳回

IAsyncOperation<StorageFolder>

當這個方法完成時，它會傳回代表新子資料夾的 StorageFolder 。

實作

M:Windows.Storage.IStorageFolder.CreateFolderAsync(System.String) M:Windows.Storage.IStorageFolder.CreateFolderAsync(Platform::String) M:Windows.Storage.IStorageFolder.CreateFolderAsync(winrt::hstring)
屬性
OverloadAttribute RemoteAsyncAttribute

例外狀況

FileNotFoundException

資料夾名稱包含不正確字元，或資料夾名稱的格式不正確。 檢查 desiredName的值。

UnauthorizedAccessException

您沒有在目前資料夾中建立子資料夾的許可權。

範例

下列範例示範如何呼叫CreateFolderAsync (String、CreationCollisionOption) 多載方法，在目前資料夾中建立新的StorageFolder。 這個範例會明確指定選項的值，如果目前資料夾中已有具有指定desiredName的資料夾，該選項會導致作業失敗。

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

備註

此方法預設會使用CreationCollisionOption列舉中的FailIfExists值。 也就是說，如果目前資料夾中已有同名的子資料夾，這個方法就會引發例外狀況。 如果您想要以不同的方式處理資料夾名稱衝突，請呼叫 CreateFolderAsync (String、CreationCollisionOption) 方法。

例如，如果您嘗試在虛擬資料夾中建立子資料夾，例如程式庫，或代表檔案群組容器的資料夾 (，例如， GetFoldersAsync 方法) 的某些多載傳回值，CreateFolderAsync 方法可能會失敗。

另請參閱

適用於

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)

參數

desiredName
String

Platform::String

winrt::hstring

目前資料夾中要建立的新子資料夾名稱。

options
CreationCollisionOption

其中一個列舉值，決定如果具有指定 desiredName 的子資料夾已存在於目前資料夾中，該如何處理衝突。

傳回

IAsyncOperation<StorageFolder>

當這個方法完成時，它會傳回代表新子資料夾的 StorageFolder 。

實作

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)
屬性
OverloadAttribute RemoteAsyncAttribute

例外狀況

FileNotFoundException

資料夾名稱包含不正確字元，或資料夾名稱的格式不正確。 檢查 desiredName的值。

UnauthorizedAccessException

您沒有在目前資料夾中建立子資料夾的許可權。

備註

如果目前資料夾中已有具有指定 desiredName 的資料夾，則指定的 CreationCollisionOption 會決定如何處理衝突。

另請參閱

適用於