FileSystem.Rename(String, String) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.VisualBasic

Zestaw:: Microsoft.VisualBasic.Core.dll

Zestaw:: Microsoft.VisualBasic.dll

Źródło:: FileSystem.vb

Źródło:: FileSystem.vb

Źródło:: FileSystem.vb

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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: SupportedOSPlatformAttribute

Wyjątki

ArgumentException

Ścieżka jest nieprawidłowa.

FileNotFoundException

OldPath plik nie istnieje.

IOException

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