File.RenameTo(File) Método

Referência

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 for 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: <ul><li>A permissão de gravação é necessária nos diretórios que contêm os caminhos de origem e destino. <A>permissão de pesquisa é 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 de retorno deve sempre ser verificado para certificar-se de que 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.

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

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

Aplica-se a

Compartilhar via