FileSystem.Rename(String, String) Método

Referência

Definição

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Origem:: FileSystem.vb

Origem:: FileSystem.vb

Origem:: FileSystem.vb

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 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: 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.

Aplica-se a

Compartilhar via