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)

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에서 충돌을 처리하는 방법을 결정합니다.

추가 정보

• CreateFolderAsync(String)