File Classe
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.
Uma representação abstrata de nomes de caminho de arquivo e diretório.
[Android.Runtime.Register("java/io/File", DoNotGenerateAcw=true)]
public class File : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Lang.IComparable[<Android.Runtime.Register("java/io/File", DoNotGenerateAcw=true)>]
type File = class
inherit Object
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface IComparable- Herança
- Atributos
- Implementações
Comentários
Uma representação abstrata de nomes de caminho de arquivo e diretório.
Interfaces de usuário e sistemas operacionais usam cadeias de caracteres de nome de caminho dependentes <><do sistema/em> para nomear arquivos e diretórios. Essa classe apresenta uma exibição abstrata e independente do sistema de nomes de caminho hierárquicos. Um <nome>de caminho</em> abstrato tem dois componentes:
O nome em um nome de caminho abstrato pode ser um nome de diretório ou, no caso de nomes de caminho UNC Microsoft Windows, um nome de host. Cada nome subsequente em um nome de caminho abstrato indica um diretório; o sobrenome pode indicar um diretório ou um arquivo. <O >nome de caminho em vazio</em> abstrato não tem nenhum prefixo e uma sequência de nomes vazia.
A conversão de uma cadeia de caracteres de nome de caminho de ou para um nome de caminho abstrato é inerentemente dependente do sistema. Quando um nome de caminho abstrato é convertido em uma cadeia de caracteres pathname, cada nome é separado do próximo por uma única cópia do caractere/em< separador padrão.><> O caractere separador de nome padrão é definido pela propriedade file.separatordo sistema e é disponibilizado nos campos estáticos públicos {@link #separator} e {@link #separatorChar} dessa classe. Quando uma cadeia de caracteres de nome de caminho é convertida em um nome de caminho abstrato, os nomes dentro dela podem ser separados pelo caractere separador de nome padrão ou por qualquer outro caractere separador de nome compatível com o sistema subjacente.
Um nome de caminho, seja abstrato ou em forma de cadeia de caracteres, pode ser em absoluto/em< ou >em<relativo>/em<.><> Um nome de caminho absoluto é concluído, pois nenhuma outra informação é necessária para localizar o arquivo que ele denota. Um nome de caminho relativo, em contraste, deve ser interpretado em termos de informações obtidas de algum outro nome de caminho. Por padrão, as classes no java.io pacote sempre resolvem nomes de caminho relativos no diretório do usuário atual. Esse diretório é nomeado pela propriedade user.dirdo sistema e normalmente é o diretório no qual a máquina virtual Java foi invocada.
O <pai></em> de um nome de caminho abstrato pode ser obtido invocando o #getParent método dessa classe e consiste no prefixo do nome do caminho e em cada nome na sequência de nomes do nome do nome do caminho, exceto o último. O nome de caminho absoluto de cada diretório é um ancestral de qualquer File objeto com um nome de caminho abstrato absoluto que começa com o nome de caminho absoluto do diretório. Por exemplo, o diretório indicado pelo nome de caminho "/usr" abstrato é um ancestral do diretório indicado pelo nome do caminho "/usr/local/bin".
O conceito de prefixo é usado para lidar com diretórios raiz em plataformas UNIX e especificadores de unidade, diretórios raiz e nomes de caminho UNC em plataformas Microsoft Windows, da seguinte maneira:
<ul>
<li> Para plataformas UNIX, o prefixo de um nome de caminho absoluto é sempre "/". Nomes de caminho relativos não têm prefixo. O nome de caminho abstrato que indica o diretório raiz tem o prefixo "/" e uma sequência de nomes vazia.
<li> Para Microsoft Windows plataformas, o prefixo de um nome de caminho que contém um especificador de unidade consiste na letra da unidade seguida ":" e possivelmente seguida pelo "\\" nome do caminho é absoluto. O prefixo de um nome de caminho UNC é "\\\\"; o nome do host e o nome do compartilhamento são os dois primeiros nomes na sequência de nomes. Um nome de caminho relativo que não especifica uma unidade não tem nenhum prefixo.
</ul>
Instâncias dessa classe podem ou não denotar um objeto real do sistema de arquivos, como um arquivo ou um diretório. Se ele denotar tal objeto, esse objeto residirá em uma partição. Uma partição é uma parte de armazenamento específica do sistema operacional para um sistema de arquivos. Um único dispositivo de armazenamento (por exemplo, uma unidade de disco física, memória flash, CD-ROM) pode conter várias partições. O objeto, se houver, residirá na partição "partName"> nomeada por algum ancestral da forma absoluta deste nome de caminho.
Um sistema de arquivos pode implementar restrições a determinadas operações no objeto real do sistema de arquivos, como leitura, gravação e execução. Essas restrições são coletivamente conhecidas como permissões de acesso. O sistema de arquivos pode ter vários conjuntos de permissões de acesso em um único objeto. Por exemplo, um conjunto pode se aplicar ao proprietário do objeto e outro pode se aplicar a todos os outros usuários. As permissões de acesso em um objeto podem fazer com que alguns métodos nessa classe falhem.
As instâncias da File classe são imutáveis; ou seja, uma vez criadas, o nome de caminho abstrato representado por um File objeto nunca será alterado.
<Interoperabilidade h3>com java.nio.file pacote</h3>
O <pacote c> java.nio.file</c> define interfaces e classes para a máquina virtual Java acessar arquivos, atributos de arquivo e sistemas de arquivos. Essa API pode ser usada para superar muitas das limitações da java.io.File classe. O #toPath toPath método pode ser usado para obter um Path que usa o caminho abstrato representado por um File objeto para localizar um arquivo. O resultado Path pode ser usado com a java.nio.file.Files classe para fornecer acesso mais eficiente e extensivo a operações de arquivo adicionais, atributos de arquivo e exceções de E/S para ajudar a diagnosticar erros quando uma operação em um arquivo falha.
Em cadeias de caracteres Android são convertidas em sequências de bytes UTF-8 ao enviar nomes de arquivo para o sistema operacional, e sequências de bytes retornadas pelo sistema operacional (dos vários list métodos) são convertidas em cadeias de caracteres decodificando-as como sequências de bytes UTF-8.
Adicionado no JDK1.0.
Java documentação para java.io.File.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.
Construtores
| Nome | Description |
|---|---|
| File(File, String) |
Cria uma nova |
| File(IntPtr, JniHandleOwnership) |
Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo runtime. |
| File(String, String) |
Cria uma nova |
| File(String) |
Cria uma nova |
| File(URI) |
Cria uma nova |
Propriedades
| Nome | Description |
|---|---|
| AbsoluteFile |
Retorna a forma absoluta deste nome de caminho abstrato. |
| AbsolutePath |
Retorna o caminho absoluto deste arquivo. |
| CanonicalFile |
Retorna a forma canônica deste nome de caminho abstrato. |
| CanonicalPath |
Retorna a cadeia de caracteres de nome de caminho canônico deste nome de caminho abstrato. |
| Class |
Retorna a classe de runtime deste |
| FreeSpace |
Retorna o número de bytes não alocados na partição nomeada por esse nome de caminho abstrato. |
| Handle |
O identificador para a instância subjacente do Android. (Herdado de Object) |
| IsAbsolute |
Testa se esse nome de caminho abstrato é absoluto. |
| IsDirectory |
Testa se o arquivo indicado por esse nome de caminho abstrato é um diretório. |
| IsFile |
Testa se o arquivo indicado por esse nome de caminho abstrato é um arquivo normal. |
| IsHidden |
Testa se o arquivo nomeado por esse nome de caminho abstrato é um arquivo oculto. |
| JniIdentityHashCode |
Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object) |
| JniManagedPeerState |
Uma representação abstrata de nomes de caminho de arquivo e diretório. (Herdado de JavaObject) |
| JniPeerMembers |
Uma representação abstrata de nomes de caminho de arquivo e diretório. |
| Name |
Retorna o nome do arquivo ou diretório indicado por esse nome de caminho abstrato. |
| Parent |
Retorna a cadeia de caracteres de nome de caminho do pai desse nome de caminho abstrato ou |
| ParentFile |
Retorna o nome de caminho abstrato do pai desse nome de caminho abstrato ou |
| Path |
Converte esse nome de caminho abstrato em uma cadeia de caracteres pathname. |
| PathSeparator |
O caractere separador de caminho dependente do sistema, representado como uma cadeia de caracteres para conveniência. |
| PathSeparatorChar |
O caractere separador de caminho dependente do sistema. |
| PeerReference |
Obtém a referência de objeto JNI para este par Java. (Herdado de Object) |
| Separator |
O caractere separador de nome padrão dependente do sistema, representado como uma cadeia de caracteres para conveniência. |
| SeparatorChar |
O caractere separador de nome padrão dependente do sistema. |
| ThresholdClass |
Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. |
| ThresholdType |
Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. |
| TotalSpace |
Retorna o tamanho da partição nomeada por este nome de caminho abstrato. |
| UsableSpace |
Retorna o número de bytes disponíveis para essa máquina virtual na partição nomeada por esse nome de caminho abstrato. |
Métodos
| Nome | Description |
|---|---|
| CanExecute() |
Testa se o aplicativo pode executar o arquivo indicado por esse nome de caminho abstrato. |
| CanRead() |
Testa se o aplicativo pode ler o arquivo indicado por esse nome de caminho abstrato. |
| CanWrite() |
Testa se o aplicativo pode modificar o arquivo indicado por esse nome de caminho abstrato. |
| Clone() |
Cria e retorna uma cópia desse objeto. (Herdado de Object) |
| CompareTo(File) |
Compara dois nomes de caminho abstratos lexicograficamente. |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Uma representação abstrata de nomes de caminho de arquivo e diretório. (Herdado de JavaObject) |
| CreateNewFile() |
Atomicamente cria um novo arquivo vazio nomeado por esse nome de caminho abstrato se e somente se um arquivo com esse nome ainda não existir. |
| CreateTempFile(String, String, File) |
Cria um novo arquivo vazio no diretório especificado, usando as cadeias de caracteres de prefixo e sufixo fornecidas para gerar seu nome. |
| CreateTempFile(String, String) |
Cria um arquivo vazio no diretório de arquivo temporário padrão, usando o prefixo e o sufixo fornecidos para gerar seu nome. |
| Delete() |
Exclui o arquivo ou diretório indicado por esse nome de caminho abstrato. |
| DeleteOnExit() |
Solicita que o arquivo ou diretório indicado por esse nome de caminho abstrato seja excluído quando a máquina virtual for encerrada. |
| Dispose() |
Libera os recursos mantidos por esse par Java. (Herdado de Object) |
| Dispose(Boolean) |
Libera os recursos mantidos por esse par Java. (Herdado de Object) |
| DisposeUnlessReferenced() |
Uma representação abstrata de nomes de caminho de arquivo e diretório. (Herdado de JavaObject) |
| Equals(Object) |
Uma representação abstrata de nomes de caminho de arquivo e diretório. (Herdado de JavaObject) |
| Equals(Object) |
Indica se algum outro objeto é "igual a" este. (Herdado de Object) |
| Exists() |
Testa se o arquivo ou diretório indicado por esse nome de caminho abstrato existe. |
| GetHashCode() |
Retorna um valor de código hash para o objeto. (Herdado de Object) |
| JavaFinalize() |
Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto. (Herdado de Object) |
| LastModified() |
Retorna a hora em que o arquivo indicado por esse nome de caminho abstrato foi modificado pela última vez. |
| Length() |
Retorna o comprimento do arquivo indicado por esse nome de caminho abstrato. |
| List() |
Retorna uma matriz de cadeias de caracteres nomeando os arquivos e diretórios no diretório indicado por esse nome de caminho abstrato. |
| List(IFilenameFilter) |
Retorna uma matriz de cadeias de caracteres nomeando os arquivos e diretórios no diretório indicado por esse nome de caminho abstrato que satisfaz o filtro especificado. |
| ListAsync() |
Uma representação abstrata de nomes de caminho de arquivo e diretório. |
| ListAsync(IFilenameFilter) |
Uma representação abstrata de nomes de caminho de arquivo e diretório. |
| ListFiles() |
Retorna uma matriz de nomes de caminho abstratos denotando os arquivos no diretório indicado por esse nome de caminho abstrato. |
| ListFiles(IFileFilter) |
Retorna uma matriz de nomes de caminho abstratos que denotam os arquivos e diretórios no diretório indicado por esse nome de caminho abstrato que satisfaz o filtro especificado. |
| ListFiles(IFilenameFilter) |
Retorna uma matriz de nomes de caminho abstratos que denotam os arquivos e diretórios no diretório indicado por esse nome de caminho abstrato que satisfaz o filtro especificado. |
| ListFilesAsync() |
Uma representação abstrata de nomes de caminho de arquivo e diretório. |
| ListFilesAsync(IFileFilter) |
Uma representação abstrata de nomes de caminho de arquivo e diretório. |
| ListFilesAsync(IFilenameFilter) |
Uma representação abstrata de nomes de caminho de arquivo e diretório. |
| ListRoots() |
Retorna as raízes do sistema de arquivos. |
| ListRootsAsync() |
Uma representação abstrata de nomes de caminho de arquivo e diretório. |
| Mkdir() |
Cria o diretório nomeado por esse nome de caminho abstrato. |
| Mkdirs() |
Cria o diretório nomeado por esse nome de caminho abstrato, incluindo todos os diretórios pai necessários, mas inexistentes. |
| Notify() |
Ativa um único thread que está aguardando no monitor deste objeto. (Herdado de Object) |
| NotifyAll() |
Ativa todos os threads que estão aguardando no monitor deste objeto. (Herdado de Object) |
| RenameTo(File) |
Renomeia o arquivo indicado por esse nome de caminho abstrato. |
| SetExecutable(Boolean, Boolean) |
Define a permissão de execução do proprietário ou de todos para esse nome de caminho abstrato. |
| SetExecutable(Boolean) |
Um método de conveniência para definir a permissão de execução do proprietário para esse nome de caminho abstrato. |
| SetHandle(IntPtr, JniHandleOwnership) |
Define a propriedade Handle (Herdado de Object) |
| SetLastModified(Int64) |
Define a hora da última modificação do arquivo ou diretório nomeado por esse nome de caminho abstrato. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Uma representação abstrata de nomes de caminho de arquivo e diretório. (Herdado de JavaObject) |
| SetReadable(Boolean, Boolean) |
Define a permissão de leitura do proprietário ou de todos para este nome de caminho abstrato. |
| SetReadable(Boolean) |
Um método de conveniência para definir a permissão de leitura do proprietário para esse nome de caminho abstrato. |
| SetReadOnly() |
Marca o arquivo ou diretório nomeado por esse nome de caminho abstrato para que somente as operações de leitura sejam permitidas. |
| SetWritable(Boolean, Boolean) |
Define a permissão de gravação do proprietário ou de todos para esse nome de caminho abstrato. |
| SetWritable(Boolean) |
Um método de conveniência para definir a permissão de gravação do proprietário para esse nome de caminho abstrato. |
| ToArray<T>() |
Cria uma matriz gerenciada com base nesse wrapper de matriz Java. (Herdado de Object) |
| ToPath() |
Retorna um |
| ToString() |
Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object) |
| ToURI() |
Constrói um |
| ToURL() |
Obsoleto.
Converte esse nome de caminho abstrato em uma |
| UnregisterFromRuntime() |
Cancela o registro desse par Java do runtime de interoperabilidade. (Herdado de Object) |
| Wait() |
Faz com que o thread atual aguarde até ser despertado, normalmente por ser <notificado/em> ou <em>interrompido</em>.<> (Herdado de Object) |
| Wait(Int64, Int32) |
Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object) |
| Wait(Int64) |
Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IComparable.CompareTo(Object) |
Uma representação abstrata de nomes de caminho de arquivo e diretório. |
| IJavaPeerable.Disposed() |
Uma representação abstrata de nomes de caminho de arquivo e diretório. (Herdado de JavaObject) |
| IJavaPeerable.Finalized() |
Uma representação abstrata de nomes de caminho de arquivo e diretório. (Herdado de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Uma representação abstrata de nomes de caminho de arquivo e diretório. (Herdado de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Uma representação abstrata de nomes de caminho de arquivo e diretório. (Herdado de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Uma representação abstrata de nomes de caminho de arquivo e diretório. (Herdado de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Uma representação abstrata de nomes de caminho de arquivo e diretório. (Herdado de JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
Uma representação abstrata de nomes de caminho de arquivo e diretório. |
Métodos de Extensão
| Nome | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtém o nome JNI do tipo da instância |
| JavaAs<TResult>(IJavaPeerable) |
Tente coagir a digitar |
| JavaCast<TResult>(IJavaObject) |
Executa uma conversão de tipo marcada por runtime do Android. |
| JavaCast<TResult>(IJavaObject) |
Uma representação abstrata de nomes de caminho de arquivo e diretório. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Tente coagir a digitar |