情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

IStorageItem.RenameAsync(String) Method

現在の項目の名前を変更します。

構文


IAsyncAction RenameAsync(
  string desiredName
)

パラメーター

desiredName

型: System.String [.NET] | Platform::String [C++]

項目の任意の新しい名前。

戻り値

型: IAsyncAction

このメソッドでは、完了時にオブジェクトまたは値は返りません。

注釈

無効な名前を指定すると、このメソッドは例外をスローします。指定した名前を無効にできるすべての方法を処理するには、これらの例外の 4 つすべてをキャッチする必要があります。

E_INVALIDARG
E_FAIL
ERROR_FILENAME_EXCED_RANGE
ERROR_INVALID_NAME

 

名前変更が終了する前にファイルが削除された場合は、このメソッドは ERROR_FILE_NOT_FOUND の例外をスローします。このメソッドを使用する場合は、この例外をキャッチして処理することも必要です。

要件

サポートされている最小のクライアント

Windows 8

サポートされている最小のサーバー

Windows Server 2012

サポートされている最小の電話

Windows Phone 8

名前空間

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

メタデータ

Windows.winmd

参照

IStorageItem
RenameAsync(String, NameCollisionOption)

 

 

表示: