Bagikan melalui

FileSystem.Rename(String, String) Metode

Definisi

Ruang nama:
Microsoft.VisualBasic
Rakitan:
Microsoft.VisualBasic.Core.dll
Rakitan:
Microsoft.VisualBasic.dll
Sumber:
FileSystem.vb
Sumber:
FileSystem.vb
Sumber:
FileSystem.vb

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
SupportedOSPlatformAttribute

Pengecualian

ArgumentException

Jalur tidak valid.

FileNotFoundException

OldPath file tidak ada.

IOException

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.

Berlaku untuk

Lihat juga