FileSystem.Rename(String, String) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Byter namn på en diskfil eller katalog. Funktionen My ger bättre produktivitet och prestanda i fil-I/O-åtgärder än Rename. Mer information finns i 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)Parametrar
- OldPath
- String
Required. Ett stränguttryck som anger det befintliga filnamnet och platsen.
OldPath kan innehålla filens katalog och enhet.
- NewPath
- String
Required. Ett stränguttryck som anger det nya filnamnet och platsen.
NewPath kan innehålla katalog och enhet för målplatsen. Det filnamn som anges av NewPath kan inte redan finnas.
- Attribut
Undantag
Sökvägen är ogiltig.
OldPath filen finns inte.
Det går inte att byta namn på en annan enhet.
Exempel
I det Rename här exemplet används funktionen för att byta namn på en fil. I det här exemplet förutsätter vi att de kataloger som har angetts redan finns.
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)
Kommentarer
FunktionenRename byter namn på en fil och flyttar den till en annan katalog, om det behövs. Funktionen Rename kan flytta en fil mellan enheter, men den kan bara byta namn på en befintlig katalog när båda NewPath och OldPath finns på samma enhet.
Rename kan inte skapa en ny fil eller katalog.
Rename Om du använder funktionen i en öppen fil uppstår ett fel. Du måste stänga en öppen fil innan du byter namn på den.
Rename argument kan inte innehålla jokertecken med flera tecken (*) och ett tecken (?).
Important
När du använder Rename för att kopiera en fil från en oskyddad plats till en skyddad plats behåller filen de mindre begränsade rättigheterna. Kontrollera att du inte inför en möjlig säkerhetsrisk.
