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 runtime jazyka Visual Basic My.Computer.FileSystem nebo objekt poskytovaný prostřednictvím .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í pomocí modulu Visual Basic run-time

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).
• newName obsahuje informace o cestě (ArgumentException).
• Cesta není platná, protože je Nothing (ArgumentNullException).
• newName je Nothing nebo 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).

Viz také

• RenameFile
• Move
• Postupy: Přesunutí souboru
• Vytváření, odstraňování a přesouvání souborů a adresářů
• Postupy: Vytvoření kopie souboru ve stejném adresáři
• Postupy: Vytvoření kopie souboru v jiném adresáři