FileSystem.Rename(String, String) Método
Definição
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 ou diretório de disco. O My recurso oferece melhor produtividade e desempenho em operações de E/S de arquivo do que Rename. Para obter mais informações, consulte FileSystem.
public:
static void Rename(System::String ^ OldPath, System::String ^ NewPath);public static void Rename(string OldPath, string NewPath);static member Rename : string * string -> unitPublic Sub Rename (OldPath As String, NewPath As String)Parâmetros
- OldPath
- String
Required. Uma expressão de cadeia de caracteres que especifica o nome e o local do arquivo existentes.
OldPath pode incluir o diretório e a unidade do arquivo.
- NewPath
- String
Required. Uma expressão de cadeia de caracteres que especifica o novo nome e o local do arquivo.
NewPath pode incluir o diretório e a unidade do local de destino. O nome do arquivo especificado por NewPath ele ainda não existe.
Exceções
O caminho é inválido.
OldPath o arquivo não existe.
Não é possível renomear para um dispositivo diferente.
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 ambos NewPathOldPath estiverem localizados na mesma unidade.
Rename não pode criar um novo arquivo ou diretório.
Usar a Rename função em um arquivo aberto produz um erro. Tem de fechar um ficheiro aberto antes de mudar o nome do mesmo.
Rename os argumentos não podem incluir caracteres múltiplos (*) e caracteres únicos (?).
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.