Share via

FileSystem.RenameFile(String, String) Método

  • Referência

Definição

Namespace:
Microsoft.VisualBasic.FileIO
Assembly:
Microsoft.VisualBasic.Core.dll
Assembly:
Microsoft.VisualBasic.dll
Origem:
FileSystem.vb
Origem:
FileSystem.vb
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

Aplica-se a