FileSystemProxy.RenameFile(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 arquivo.
public:
void RenameFile(System::String ^ file, System::String ^ newName);public void RenameFile(string file, string newName);member this.RenameFile : string * string -> unitPublic Sub RenameFile (file As String, newName As String)Parâmetros
- file
- String
Ficheiro a ser renomeado.
- newName
- String
Novo nome do ficheiro.
Exceções
newName contém informação de caminho ou termina com uma barra inversa (\).
O ficheiro não existe.
Existe um ficheiro ou diretório existente com o nome especificado em newName.
O percurso excede o comprimento máximo definido pelo sistema.
Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.
O utilizador não tem as permissões necessárias para visualizar o caminho.
O utilizador não tem a permissão necessária.
Exemplos
Este exemplo renomeia o ficheiro Test.txt para SecondTest.txt.
My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")
Muda "C:\Test.txt" para o caminho e nome do ficheiro que queres renomear.
Observações
Este método não pode ser usado para mover um ficheiro; Use o MoveFile método para mover e renomear o ficheiro.
A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.FileSystem.RenameFile método.
| Para | Veja |
|---|---|
| Mudar o nome de um ficheiro | Como: Renomear um arquivo |