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

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

現在のフォルダーの名前を変更し、同じ名前のフォルダーが既に存在する場合、どのように処理するかを指定します。

構文


storageFolder.renameAsync(desiredName, option).done( /* サクセス ハンドラーとエラー ハンドラー */ );

パラメーター

desiredName

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

現在のフォルダーの任意の新しい名前。

指定された desiredName が既にある現在のフォルダーの場所に既存の項目が存在する場合、指定された NameCollisionOption は、Windows が競合にどのように応答するかを判断します。

option

型: NameCollisionOption

desiredName が現在のフォルダーの場所にある既存の項目名と同じ場合に Windows がどのように応答するかを決定する列挙値。

戻り値

型: 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

参照

StorageFolder
RenameAsync(String)

 

 

この情報は役に立ちましたか。
(残り 1500 文字)
フィードバックをいただき、ありがとうございました
表示:
© 2014 Microsoft. All rights reserved.