내보내기(0) 인쇄
모두 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

StorageFile.RenameAsync(String, NameCollisionOption) | renameAsync(String, NameCollisionOption) Method

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

구문


storageFile.renameAsync(desiredName, option).done( /* 성공 및 오류 처리기 */ );

매개 변수

desiredName

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

현재 파일의 원하는 새 이름입니다.

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

option

유형: NameCollisionOption

desiredName현재 파일의 위치에 있는 기존 항목의 이름과 동일한 경우 Windows에서 응답하는 방식을 결정하는 열거형 값입니다.

반환 값

유형: 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

참고 항목

StorageFile
RenameAsync(String)

 

 

표시:
© 2014 Microsoft