FileSystemProxy.RenameFile(String, String) Método

Referência

Definição

Namespace:: Microsoft.VisualBasic.MyServices

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Renomeia um arquivo.

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)

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 arquivo 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 que envolve o My.Computer.FileSystem.RenameFile método .

Para	Consulte
Renomear um arquivo	Como: renomear um arquivo

Aplica-se a

Partilhar via