Udostępnij za pośrednictwem


FileSystem.RenameFile(String, String) Metoda

Definicja

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

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

file to Nothing.

-lub-

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

Katalog nie istnieje.

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

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

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

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

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

Dotyczy