Método My.Computer.FileSystem.RenameFile
Renomeia um arquivo.
' Usage
My.Computer.FileSystem.RenameFile(file ,newName)
' Declaration
Public Sub RenameFile( _
ByVal file As String, _
ByVal newName As String _
)
Parâmetros
file
String.Arquivo a ser renomeado.Obrigatório.newName
String.Novo nome de arquivo.Obrigatório.
Exceções
As seguintes condições podem causar uma exceção:
O caminho inválido para um dos seguintes motivos: Ele é uma cadeia de comprimento zero; ele contém somente espaços em branco; ele contém caracteres inválidos; ou é um caminho de dispositivo (começa com \\.\) (ArgumentException).
O parâmetro newName contém informações de caminho ou termina com uma barra-invertida (\) (ArgumentException).
O caminho não é válido porque ele é Nothing (ArgumentNullException).
O parâmetro newName é Nothing ou uma sequência de caracteres vazia (ArgumentNullException).
O arquivo de origem não é válido ou não existe (FileNotFoundException).
Há um arquivo ou diretório existente com o nome especificado em newName (IOException).
O caminho excede o comprimento máximo definido pelo sistema (PathTooLongException).
Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido (NotSupportedException).
O usuário não possui permissões necessárias para exibir o caminho (SecurityException).
O usuário não possuia as permissões requeridas (UnauthorizedAccessException).
Comentários
Este método não pode ser usado para mover um arquivo; use o Método My.Computer.FileSystem.MoveFile para mover e renomear este arquivo
Tarefas
A tabela seguinte lista um exemplo de tarefa envolvendo o método My.Computer.FileSystem.RenameFile.
Para |
Consulte |
|---|---|
Renomear um arquivo. |
Exemplo
Este exemplo renomeia o arquivo Test.txt para SecondTest.txt.
My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")
Alterar "C:\Test.txt" para o caminho e nome do arquivo que você deseja renomear.
Requisitos
Namespace:Microsoft.VisualBasic.MyServices
Classe:FileSystemProxy (fornece acesso a FileSystem)
Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)
Disponibilidade por Tipo de Projeto
Tipo de Projeto |
Disponível |
|---|---|
Aplicativo do Windows |
Sim |
Biblioteca de Classe |
Sim |
Aplicativo de Console |
Sim |
Biblioteca de Controle do Windows |
Sim |
Biblioteca de Controle da Web |
Sim |
Serviço do Windows |
Sim |
Site |
Sim |
Permissões
A permissão a seguir pode ser necessária:
Permissão |
Descrição |
|---|---|
Controla a habilidade de acesso a arquivos e pastas.Enumeração associada: Unrestricted. |
Para obter mais informações, consulte Segurança de Acesso de código e Solicitando permissões.