다음을 통해 공유


IStorageItem.RenameAsync 메서드

정의

오버로드

RenameAsync(String)

현재 항목의 이름을 바꿉니다.

RenameAsync(String, NameCollisionOption)

현재 항목의 이름을 바꿉니다. 또한 이 메서드는 현재 항목의 위치에 있는 기존 항목의 이름이 같은 경우 수행할 작업을 지정합니다.

RenameAsync(String)

현재 항목의 이름을 바꿉니다.

public:
 IAsyncAction ^ RenameAsync(Platform::String ^ desiredName);
/// [Windows.Foundation.Metadata.Overload("RenameAsyncOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction RenameAsync(winrt::hstring const& desiredName);
[Windows.Foundation.Metadata.Overload("RenameAsyncOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction RenameAsync(string desiredName);
function renameAsync(desiredName)
Public Function RenameAsync (desiredName As String) As IAsyncAction

매개 변수

desiredName
String

Platform::String

winrt::hstring

원하는 항목의 새 이름입니다.

반환

이 메서드가 완료되면 개체 또는 값이 반환되지 않습니다.

특성

설명

이 메서드 및 해당 오버로드의 경우 지정한 이름이 잘못된 경우 이 메서드는 예외를 throw합니다. 지정된 이름이 유효하지 않을 수 있는 모든 방법을 처리하려면 다음 네 가지 예외를 모두 catch해야 합니다.

E_INVALIDARG
E_FAIL
ERROR_FILENAME_EXCED_RANGE
ERROR_INVALID_NAME

이름이 바뀌기 전에 파일이 삭제되면 이 메서드는 ERROR_FILE_NOT_FOUND 예외를 throw합니다. 또한 이 메서드를 사용할 때 이 예외를 catch하고 처리해야 합니다.

추가 정보

적용 대상

RenameAsync(String, NameCollisionOption)

현재 항목의 이름을 바꿉니다. 또한 이 메서드는 현재 항목의 위치에 있는 기존 항목의 이름이 같은 경우 수행할 작업을 지정합니다.

public:
 IAsyncAction ^ RenameAsync(Platform::String ^ desiredName, NameCollisionOption option);
/// [Windows.Foundation.Metadata.Overload("RenameAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction RenameAsync(winrt::hstring const& desiredName, NameCollisionOption const& option);
[Windows.Foundation.Metadata.Overload("RenameAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction RenameAsync(string desiredName, NameCollisionOption option);
function renameAsync(desiredName, option)
Public Function RenameAsync (desiredName As String, option As NameCollisionOption) As IAsyncAction

매개 변수

desiredName
String

Platform::String

winrt::hstring

현재 항목의 원하는 새 이름입니다.

현재 항목의 위치에 지정된 desiredName이 이미 있는 기존 항목이 있는 경우 지정된 NameCollisionOption 은 Windows가 충돌에 대응하는 방법을 결정합니다.

option
NameCollisionOption

desiredName이 현재 항목의 위치에 있는 기존 항목의 이름과 같은 경우 Windows가 응답하는 방법을 결정하는 열거형 값입니다.

반환

이 메서드가 완료되면 개체 또는 값이 반환되지 않습니다.

특성

추가 정보

적용 대상