FileSystem.Rename(String, String) メソッド

定義

ディスク ファイルまたはディレクトリの名前を変更します。 My 機能を使用すると、Rename よりもファイル I/O 処理の生産性とパフォーマンスが向上します。 詳細については、「FileSystem」を参照してください。

public:
 static void Rename(System::String ^ OldPath, System::String ^ NewPath);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void Rename (string OldPath, string NewPath);
public static void Rename (string OldPath, string NewPath);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Rename : string * string -> unit
static member Rename : string * string -> unit
Public Sub Rename (OldPath As String, NewPath As String)

パラメーター

OldPath
String

必須です。 既存のファイルの名前と場所を指定する文字列式です。 OldPath には、ファイルのディレクトリおよびドライブを含めることができます。

NewPath
String

必須です。 新しいファイルの名前と場所を指定する文字列式です。 NewPath には、出力先のディレクトリおよびドライブを含めることができます。 NewPath には、既に存在しているファイル名は指定できません。

属性

例外

パスが無効です。

OldPath ファイルが存在しません。

異なるデバイスには名前を変更できません。

この例では、 関数を Rename 使用してファイルの名前を変更します。 この例では、指定されたディレクトリが既に存在するとします。

Dim OldName, NewName As String
OldName = "OLDFILE"
' Define file names.
NewName = "NEWFILE"
' Rename file.
Rename(OldName, NewName)

OldName = "C:\OLDDIR\OLDFILE"
NewName = "C:\NEWDIR\NEWFILE"
' Move and rename file.
Rename(OldName, NewName)

注釈

関数はRename ファイルの名前を変更し、必要に応じて別のディレクトリに移動します。 この関数はRenameドライブ間でファイルを移動できますが、既存のディレクトリの名前を変更できるのは、 と OldPath の両方NewPathが同じドライブにある場合のみです。 Rename は新しいファイルまたはディレクトリを作成できません。

Rename開いているファイルで 関数を使用すると、エラーが発生します。 名前を変更する前に、開いているファイルを閉じる必要があります。 Rename 引数に複数文字 (*) と単一文字 (?) のワイルドカードを含めることはできません。

重要

を使用して Rename 保護されていない場所から保護された場所にファイルをコピーする場合、ファイルは制限の少ない権限を保持します。 考えられるセキュリティ リスクが導入されていないことを確認します。

適用対象

こちらもご覧ください