File.RenameTo(File) Método

Definição

Namespace:: Java.IO

Assembly:: Mono.Android.dll

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 o arquivo indicado por esse nome de caminho abstrato.

[Android.Runtime.Register("renameTo", "(Ljava/io/File;)Z", "GetRenameTo_Ljava_io_File_Handler")]
public virtual bool RenameTo(Java.IO.File dest);

[<Android.Runtime.Register("renameTo", "(Ljava/io/File;)Z", "GetRenameTo_Ljava_io_File_Handler")>]
abstract member RenameTo : Java.IO.File -> bool
override this.RenameTo : Java.IO.File -> bool

Parâmetros

dest: File

O novo nome de caminho abstrato para o arquivo nomeado

Retornos

Boolean

true se e somente se a renomeação tiver sido bem-sucedida; false caso contrário,

Atributos: RegisterAttribute

Comentários

Renomeia o arquivo indicado por esse nome de caminho abstrato.

Muitas falhas são possíveis. Algumas das falhas mais prováveis incluem: <a permissão ul><li>Write é necessária nos diretórios que contêm os caminhos de origem e de destino. <a permissão li>Search é necessária para todos os pais de ambos os caminhos. <li>Ambos os caminhos estão no mesmo ponto de montagem. No Android, é mais provável que os aplicativos atinjam essa restrição ao tentar copiar entre o armazenamento interno e um cartão SD. </ul>

O valor retornado sempre deve ser verificado para verificar se a operação de renomeação foi bem-sucedida.

Observe que a java.nio.file.Files classe define o java.nio.file.Files#move move método para mover ou renomear um arquivo de maneira independente da plataforma.

Java documentação para java.io.File.renameTo(java.io.File).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a