FileSystem.RenameFile(String, String) Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic.FileIO

Zestaw:

Microsoft.VisualBasic.Core.dll

Źródło:

FileSystem.vb

Zmienia nazwę pliku.

public:
 static void RenameFile(System::String ^ file, System::String ^ newName);

public static void RenameFile (string file, string newName);

static member RenameFile : string * string -> unit

Public Shared Sub RenameFile (file As String, newName As String)

Parametry

file

String

Nazwa pliku, który ma zostać zmieniony.

newName

String

Nowa nazwa pliku.

Wyjątki

ArgumentException

newName zawiera informacje o ścieżce lub kończy ukośnikiem odwrotnym (\).

ArgumentNullException

file to Nothing.

-lub-

newName jest Nothing ciągiem lub ciągiem pustym.

FileNotFoundException

Katalog nie istnieje.

IOException

Istnieje plik lub katalog o nazwie określonej w newNamepliku .

PathTooLongException

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

NotSupportedException

Nazwa pliku lub katalogu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

UnauthorizedAccessException

Użytkownik nie ma wymaganych uprawnień.

Przykłady

W tym przykładzie zmieniono nazwę pliku Test.txt na SecondTest.txt.

My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")

Zmień wartość "C:\Test.txt" na ścieżkę i nazwę pliku, którego nazwę chcesz zmienić.

Uwagi

Tej metody nie można użyć do przeniesienia pliku; MoveFile Użyj metody , aby przenieść i zmienić nazwę pliku.

W poniższej tabeli przedstawiono przykład zadania obejmującego metodę My.Computer.FileSystem.RenameFile .

Działanie	Zobacz
Zmienianie nazwy pliku	Porady: zmienianie nazwy pliku w Visual Basic