FileSystem.Rename(String, String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ディスク ファイルまたはディレクトリの名前を変更します。
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 -> unitstatic member Rename : string * string -> unitPublic 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関数はドライブ間でファイルを移動できますが、NewPathとOldPathの両方が同じドライブにある場合にのみ、既存のディレクトリの名前を変更できます。
Rename では、新しいファイルまたはディレクトリを作成できません。
開いているファイルで Rename 関数を使用すると、エラーが発生します。 ファイルの名前を変更する前に、そのファイルを閉じる必要があります。
Rename 引数に複数文字 (*) と単一文字 (?) のワイルドカードを含めることはできません。
Important
Renameを使用して保護されていない場所から保護された場所にファイルをコピーする場合、ファイルは制限の少ない権限を保持します。 考えられるセキュリティ リスクが発生していないことを確認します。
