Renomear função

Artigo
08/25/2010

Renomeia um arquivo de disco ou diretório.

O recurso My dá a você maior produtividade e desempenho em operações de E/S de arquivos que Rename.Para obter mais informações, consulte Objeto My.Computer.FileSystem.

Public Sub Rename( _
   ByVal OldPath As String, _
   ByVal NewPath As String _
)

Parâmetros

OldPath
Obrigatório.String expressão que especifica o nome de arquivo existente e o local. OldPath podem incluir o diretório e unidade, do arquivo.
NewPath
Obrigatório.String expressão que especifica o novo nome de arquivo e o local. NewPath pode incluir diretório e unidade do local de destino. O nome de arquivo especificado por NewPath não pode já existir.

Exceções

Tipo de exceção	Número de erro	Condição
ArgumentException	5	O caminho é inválido.
FileNotFoundException	53	Arquivo OldPath não existe.
IOException	58	O arquivo NewPath já existe
IOException	75	O acesso é inválido.
IOException	74	Não é possível renomear com outro dispositivo.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

A função Rename renomeia um arquivo e move-lo para um diretório diferente, se necessário.The Rename função pode mover um arquivo em unidades, mas só pode renomear um diretório existente quando ambos NewPath e OldPath estão localizadas na mesma unidade. Rename não é possível criar um novo arquivo ou diretório.

Usando a função Rename em um arquivo aberto produz um erro.Você deve fechar um arquivo em aberto antes de renomeá-lo.Rename argumentos não é possível incluir vários caracteres (*) e caracteres curinga de caractere único (?).

Observação de segurança:
Ao usar Rename Para copiar um arquivo de um local desprotegido para um local protegido, o arquivo manterá os direitos menos restritos. Verifique para certificar-se de que você não está apresentando um possível risco de segurança.

Exemplo

Este exemplo usa a função Rename Para renomear um arquivo.Para os fins deste exemplo, suponha que os diretórios que são especificados já existem.

Dim OldName, NewName As String
OldName = "OLDFILE"
' Define file names.
NewName = "NEWFILE"
' Rename file.
Rename(OldName, NewName)

OldName = "C:\OLDDIR\OLDFILE"
NewName = "C:\NEWDIR\NEWFILE"
' Move and rename file.
Rename(OldName, NewName)