Postupy: Přejmenování souboru v jazyce Visual Basic
V jazyce Visual Basic existují dva způsoby přejmenování souboru. K přejmenování souboru můžete použít objekt My.Computer.FileSystem runtime jazyka Visual Basic nebo zadaný objekt .NET System.IO.File .
Přejmenování pomocí .NET
Objekt System.IO.File neobsahuje metodu pro přejmenování souboru, místo toho použijte Move metodu k "přesunutí" souboru do stejného umístění, ale s jiným názvem souboru. Tuto metodu lze také použít k přesunutí souboru do jiného umístění s jiným názvem, provedení přesunutí a přejmenování společně.
Následující příklad přejmenuje soubor umístěný ve My Documents složce z TextFile.txt do NewName.txt.
Dim myDocsFolder As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments
Dim filePathSource = System.IO.Path.Combine(myDocsFolder, "TextFile.txt")
Dim filePathTarget = System.IO.Path.Combine(myDocsFolder, "NewName.txt")
System.IO.File.Move(filePathSource, filePathTarget)
Přejmenování za běhu jazyka Visual Basic
RenameFile Použijte metodu objektu My.Computer.FileSystem k přejmenování souboru zadáním úplné cesty k souboru a názvu nového souboru. Tuto metodu nelze použít k přesunutí souboru do jiného adresáře. Informace o přesunutí souboru najdete v tématu Postupy: Přesunutí souboru v jazyce Visual Basic.
Následující příklad přejmenuje soubor umístěný ve My Documents složce z TextFile.txt do NewName.txt.
Dim myDocsFolder As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments
Dim filePath = System.IO.Path.Combine(myDocsFolder, "TextFile.txt")
My.Computer.FileSystem.RenameFile(filePath, "NewName.txt")
Visual Studio poskytuje fragment kódu IntelliSense, který používá My.Computer.FileSystem.RenameFile. Fragment kódu se nachází v systému souborů – zpracování jednotek, složek a souborů. Další informace najdete v tématu Fragmenty kódu.
Robustní programování
Následující podmínky můžou způsobit výjimku:
- Cesta není platná z jednoho z následujících důvodů: je to řetězec nulové délky, obsahuje pouze prázdné znaky, obsahuje neplatné znaky nebo je to cesta zařízení (začíná řetězcem \\.\) (ArgumentException).
newNameobsahuje informace o cestě (ArgumentException).- Cesta není platná, protože je
Nothing(ArgumentNullException). newNamejeNothingnebo prázdný řetězec (ArgumentNullException).- Zdrojový soubor není platný nebo neexistuje (FileNotFoundException).
- Existuje existující soubor nebo adresář se zadaným názvem
newName(IOException). - Cesta překračuje maximální délku definovanou systémem (PathTooLongException).
- Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu (NotSupportedException).
- Uživatel nemá potřebná oprávnění k zobrazení cesty (SecurityException).
- Uživatel nemá požadovaná oprávnění (UnauthorizedAccessException).
