FileSystem.Rename(String, String) Metoda
Definicja
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ą wydajność 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 -> unitstatic member Rename : string * string -> unitPublic Sub Rename (OldPath As String, NewPath As String)Parametry
- OldPath
- String
Required. Wyrażenie ciągu określające istniejącą nazwę pliku i lokalizację.
OldPath może zawierać katalog i dysk pliku.
- NewPath
- String
Required. Wyrażenie ciągu, które określa nową nazwę i lokalizację 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 określone katalogi już 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 przenieść plik między dyskami, ale może zmienić nazwę istniejącego katalogu tylko wtedy, gdy oba NewPathOldPath te pliki znajdują 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żna
W przypadku kopiowania Rename pliku z lokalizacji niechronionej do chronionej lokalizacji plik zachowuje mniej ograniczone prawa. Upewnij się, że nie wprowadzasz możliwego ryzyka bezpieczeństwa.
