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ドライブ間でファイルを移動できますが、既存のディレクトリの名前を変更できるのは、 と OldPath の両方NewPathが同じドライブにある場合のみです。 Rename は新しいファイルまたはディレクトリを作成できません。
Rename開いているファイルで 関数を使用すると、エラーが発生します。 名前を変更する前に、開いているファイルを閉じる必要があります。 Rename 引数に複数文字 (*) と単一文字 (?) のワイルドカードを含めることはできません。
重要
を使用して Rename 保護されていない場所から保護された場所にファイルをコピーする場合、ファイルは制限の少ない権限を保持します。 考えられるセキュリティ リスクが導入されていないことを確認します。
適用対象
こちらもご覧ください
.NET