FileSystemProxy.RenameFile(String, String) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.VisualBasic.MyServices

Zestaw:: Microsoft.VisualBasic.dll

Zestaw:: Microsoft.VisualBasic.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zmienia nazwę pliku.

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

public void RenameFile (string file, string newName);

member this.RenameFile : string * string -> unit

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

Parametry

file: String

Nazwa pliku do zmiany nazwy.

newName: String

Nowa nazwa pliku.

Wyjątki

ArgumentException

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

ArgumentNullException

file to Nothing.

-lub-

newName jest lub pusty Nothing ciąg.

FileNotFoundException

Plik 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 wymieniono przykład zadania obejmującego metodę My.Computer.FileSystem.RenameFile .

Działanie	Zobacz
Zmienianie nazwy pliku	Instrukcje: Zmienianie nazwy pliku

Dotyczy

Udostępnij za pośrednictwem