FileSystem.RenameFile(String, String) Método

Definição

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

FileSystem.vb

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

ArgumentException

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

ArgumentNullException

file é Nothing.

- ou -

newName é Nothing ou é uma cadeia de caracteres vazia.

FileNotFoundException

O diretório não existe.

IOException

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

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

O usuário não tem a 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 método MoveFile para mover e renomear o arquivo.

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

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