FileSystem.Rename(String, String) Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

FileSystem.vb

Renomeia um arquivo de disco ou um diretório. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que Rename. Para obter mais informações, consulte FileSystem.

public:
 static void Rename(System::String ^ OldPath, System::String ^ NewPath);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void Rename (string OldPath, string NewPath);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Rename : string * string -> unit

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

Parâmetros

OldPath

String

Obrigatórios. Uma expressão de cadeia de caracteres que especifica o local e o nome do arquivo existente. OldPath pode incluir o diretório e a unidade do arquivo.

NewPath

String

Obrigatórios. Uma expressão de cadeia de caracteres que especifica o local e o nome do novo arquivo. NewPath pode incluir o diretório e a unidade do local de destino. O nome do arquivo especificado por NewPath não pode já existir.

Atributos

SupportedOSPlatformAttribute

Exceções

ArgumentException

Caminho inválido.

FileNotFoundException

O arquivo OldPath não existe.

IOException

Não é possível renomear com outro dispositivo.

Exemplos

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

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)

Comentários

ARename função renomeia um arquivo e o move para um diretório diferente, se necessário. A Rename função pode mover um arquivo entre unidades, mas só pode renomear um diretório existente quando e NewPathOldPath estiverem localizados na mesma unidade. Rename não é possível criar um novo arquivo ou diretório.

O uso da Rename função em um arquivo aberto produz um erro. Você deve fechar um arquivo aberto antes de renomeá-lo. Rename os argumentos não podem incluir caracteres curinga (*) e caractere único (?).

Importante

Ao usar Rename para copiar um arquivo de um local desprotegido para um local protegido, o arquivo retém os direitos menos restritos. Verifique se você não está introduzindo um possível risco de segurança.

Confira também

• Kill(String)
• ArgumentException
• FileNotFoundException
• IOException
• Como renomear um arquivo no Visual Basic