FileSystem.Rename(String, String) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengganti nama file atau direktori disk. Fitur ini My
memberi Anda produktivitas dan performa yang lebih baik dalam operasi I/O file daripada Rename
. Untuk informasi selengkapnya, lihat 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)
Parameter
- OldPath
- String
Wajib diisi. Ekspresi string yang menentukan nama dan lokasi file yang ada. OldPath
dapat mencakup direktori, dan drive, file .
- NewPath
- String
Wajib diisi. Ekspresi string yang menentukan nama dan lokasi file baru. NewPath
dapat mencakup direktori dan drive lokasi tujuan. Nama file yang ditentukan oleh NewPath
tidak boleh ada.
- Atribut
Pengecualian
Jalur tidak valid.
OldPath
file tidak ada.
Tidak dapat mengganti nama ke perangkat lain.
Contoh
Contoh ini menggunakan Rename
fungsi untuk mengganti nama file. Untuk tujuan contoh ini, asumsikan bahwa direktori yang ditentukan sudah ada.
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)
Keterangan
Fungsi menggantiRename
nama file dan memindahkannya ke direktori yang berbeda, jika diperlukan. Fungsi ini Rename
dapat memindahkan file di seluruh drive, tetapi hanya dapat mengganti nama direktori yang ada ketika keduanya NewPath
dan OldPath
terletak di drive yang sama. Rename
tidak dapat membuat file atau direktori baru.
Rename
Menggunakan fungsi pada file terbuka menghasilkan kesalahan. Anda harus menutup file yang terbuka sebelum mengganti nama file tersebut. Rename
argumen tidak dapat menyertakan kartubebas multi-karakter (*) dan karakter tunggal (?).
Penting
Saat menggunakan Rename
untuk menyalin file dari lokasi yang tidak terlindungi ke lokasi yang dilindungi, file mempertahankan hak yang kurang terbatas. Periksa untuk memastikan bahwa Anda tidak menimbulkan kemungkinan risiko keamanan.