FileSystem.RenameFile(String, String) Método

Definição

Renomeia um arquivo.

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)

Parâmetros

file
String

Arquivo a ser renomeado.

newName
String

Novo nome do arquivo.

Exceções

newName contém informações de caminho ou termina com uma barra invertida (\).

file é Nothing.

-ou-

newName é ou uma Nothing cadeia de caracteres vazia.

O diretório não existe.

Há um arquivo ou diretório existente com o nome especificado em newName.

O caminho excede o comprimento máximo definido pelo sistema.

Um nome de arquivo ou diretório no caminho contém dois-pontos (:) ou está em um formato inválido.

O usuário não tem permissões necessárias para exibir o caminho.

O usuário não tem permissão necessária.

Exemplos

Este exemplo renomeia o arquivo Test.txt para SecondTest.txt.

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

Altere "C:\Test.txt" para o caminho e o nome do arquivo que você deseja renomear.

Comentários

Esse método não pode ser usado para mover um arquivo; use o MoveFile método para mover e renomear o arquivo.

A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.FileSystem.RenameFile método.

Para Veja
Renomear um arquivo Como renomear um arquivo no Visual Basic

Aplica-se a