Udostępnij za pośrednictwem


FileSystem.Rename(String, String) Metoda

Definicja

Zmienia nazwę pliku dysku lub katalogu. Ta My funkcja zapewnia lepszą produktywność i wydajność operacji we/wy plików niż Rename. Aby uzyskać więcej informacji, zobacz 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)

Parametry

OldPath
String

Wymagane. Wyrażenie ciągu, które określa istniejącą nazwę i lokalizację pliku. OldPath może zawierać katalog i dysk pliku.

NewPath
String

Wymagane. Wyrażenie ciągu określające nazwę i lokalizację nowego pliku. NewPath może zawierać katalog i dysk lokalizacji docelowej. Nazwa pliku określona przez NewPath program nie może już istnieć.

Atrybuty

Wyjątki

Ścieżka jest nieprawidłowa.

OldPath plik nie istnieje.

Nie można zmienić nazwy na inne urządzenie.

Przykłady

W tym przykładzie użyto Rename funkcji do zmiany nazwy pliku. Na potrzeby tego przykładu załóżmy, że katalogi, które zostały już określone, istnieją.

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)

Uwagi

FunkcjaRename zmienia nazwę pliku i przenosi go do innego katalogu, jeśli jest to wymagane. Funkcja Rename może przenosić plik między dyskami, ale może zmienić nazwę istniejącego katalogu tylko wtedy, gdy oba NewPath te pliki znajdują OldPath się na tym samym dysku. Rename program nie może utworzyć nowego pliku lub katalogu.

Użycie funkcji w Rename otwartym pliku powoduje błąd. Przed zmianą nazwy należy zamknąć otwarty plik. Rename Argumenty nie mogą zawierać symboli wieloznacznych (*) i symboli wieloznacznych (?).

Ważne

Podczas kopiowania Rename pliku z lokalizacji niechronionej do chronionej lokalizacji plik zachowuje mniej ograniczone prawa. Upewnij się, że nie wprowadzono możliwego ryzyka bezpieczeństwa.

Dotyczy

Zobacz też