FileSystem.Rename(String, String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Renomeia um ficheiro de disco ou diretório. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que Rename. Para obter mais informações, veja 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 -> unitstatic member Rename : string * string -> unitPublic Sub Rename (OldPath As String, NewPath As String)Parâmetros
- OldPath
- String
Required. Uma expressão de cadeia que especifica o nome e a localização do ficheiro existentes.
OldPath pode incluir o diretório e a unidade do ficheiro.
- NewPath
- String
Required. Uma expressão string que especifica o novo nome e localização do ficheiro.
NewPath pode incluir o diretório e a unidade do local de destino. O nome do ficheiro especificado por NewPath não pode existir já.
- Atributos
Exceções
O caminho é inválido.
OldPath ficheiro não existe.
Não é possível renomear para outro dispositivo.
Exemplos
Este exemplo usa a Rename função para renomear um ficheiro. Para efeitos deste exemplo, assuma que os diretórios 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)
Observações
ARename função renomeia um ficheiro e move-o para um diretório diferente, se necessário. A Rename função pode mover um ficheiro entre discos, mas só pode renomear um diretório existente quando ambos NewPathOldPath estiverem localizados no mesmo disco.
Rename Não é possível criar um novo ficheiro ou diretório.
Usar a Rename função num ficheiro aberto produz um erro. Deve fechar um ficheiro aberto antes de o renomear.
Rename os argumentos não podem incluir curingas de múltiplos caracteres (*) e de caracteres únicos (?).
Importante
Ao usar Rename para copiar um ficheiro de um local não protegido para um local protegido, o ficheiro mantém os direitos menos restritos. Verifique se não está a apresentar um possível risco de segurança.
