MSDN Library
콘텐츠의 테이블 축소
콘텐츠의 테이블 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

IStorageItem.RenameAsync(String) Method

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

구문


IAsyncAction RenameAsync(
  string desiredName
)

매개 변수

desiredName

유형: System.String [.NET] | Platform::String [C++]

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

반환 값

유형: IAsyncAction

이 메서드가 완료될 때 개체 또는 값을 반환하지 않습니다.

설명

지정한 이름이 잘못된 경우 이 메서드에서 예외를 throw합니다. 지정된 이름이 잘못될 수 있는 모든 방식을 처리하려면 다음 예외 4개를 모두 catch해야 합니다.

E_INVALIDARG
E_FAIL
ERROR_FILENAME_EXCED_RANGE
ERROR_INVALID_NAME

 

이름 바꾸기가 완료되기 전에 파일이 삭제되면 ERROR_FILE_NOT_FOUND 예외가 throw됩니다. 또한 이 메서드를 사용할 때 이 예외를 확인하고 처리해야 합니다.

요구 사항

지원되는 최소 클라이언트

Windows 8

지원되는 최소 서버

Windows Server 2012

지원되는 최소 전화

Windows Phone 8

네임스페이스

Windows.Storage
Windows::Storage [C++]

메타데이터

Windows.winmd

참고 항목

IStorageItem
RenameAsync(String, NameCollisionOption)

 

 

표시:
© 2016 Microsoft