Compartilhar via


FileSystem.Rename(String, String) Método

Definição

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);
public static void Rename (string OldPath, string NewPath);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Rename : string * string -> unit
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

Exceções

Caminho inválido.

O arquivo OldPath não existe.

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.

Aplica-se a

Confira também