ContentResolver.OpenFileDescriptor Método

Definição

Namespace:: Android.Content

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.

Sobrecargas

Nome	Description
OpenFileDescriptor(Uri, String)	Abra um descritor de arquivo bruto para acessar dados em um URI.
OpenFileDescriptor(Uri, String, CancellationSignal)	Abra um descritor de arquivo bruto para acessar dados em um URI.

OpenFileDescriptor(Uri, String)

Abra um descritor de arquivo bruto para acessar dados em um URI.

[Android.Runtime.Register("openFileDescriptor", "(Landroid/net/Uri;Ljava/lang/String;)Landroid/os/ParcelFileDescriptor;", "")]
public Android.OS.ParcelFileDescriptor? OpenFileDescriptor(Android.Net.Uri uri, string mode);

[<Android.Runtime.Register("openFileDescriptor", "(Landroid/net/Uri;Ljava/lang/String;)Landroid/os/ParcelFileDescriptor;", "")>]
member this.OpenFileDescriptor : Android.Net.Uri * string -> Android.OS.ParcelFileDescriptor

Parâmetros

uri: Uri

O URI desejado a ser aberto.

mode: String

A representação de cadeia de caracteres do modo de arquivo. Pode ser "r", "w", "wt", "wa", "rw" ou "rwt". Observe que a implementação exata delas pode ser diferente para cada implementação do Provedor, por exemplo, "w" pode ou não truncar.

Retornos

ParcelFileDescriptor

Retorna um novo ParcelFileDescriptor apontando para o arquivo ou null se o provedor falhou recentemente. Você é o proprietário desse descritor e é responsável por fechá-lo quando terminar.

Atributos: RegisterAttribute

Exceções

FileNotFoundException

Gerará FileNotFoundException se nenhum arquivo existir no URI ou se o modo for inválido.

Comentários

Abra um descritor de arquivo bruto para acessar dados em um URI. Isso é como#openAssetFileDescriptor(Uri, String), mas usa o método ContentProvider.openFile()} subjacenteContentProvider#openFile, portanto, eles<não>/em< trabalharão >com provedores que retornam subsseções de arquivos. Se possível, você deve usar #openAssetFileDescriptor(Uri, String). Você receberá uma exceção FileNotFoundException se o provedor retornar uma sub-seção de um arquivo.

<h5>Aceita os seguintes esquemas de URI:</h5><ul><li>content (#SCHEME_CONTENT)</li><li>file (#SCHEME_FILE)</li></ul>

Confira #openAssetFileDescriptor(Uri, String) mais informações sobre esses esquemas.

Se abrir com os modos exclusivos "r" ou "w", o ParcelFileDescriptor retornado poderá ser um par de pipes ou soquetes para habilitar o streaming de dados. Abrir com o modo "rw" implica um arquivo no disco que dá suporte à busca. Se possível, sempre use um modo exclusivo para dar mais flexibilidade ao subjacente ContentProvider .

Se você estiver escrevendo um arquivo e precisar comunicar um erro ao provedor, use ParcelFileDescriptor#closeWithError(String).

Java documentação para android.content.ContentResolver.openFileDescriptor(android.net.Uri, java.lang.String).

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.

Confira também

<xref:Android.Content.ContentResolver.OpenAssetFileDescriptor(Android.Net.Uri%2c+System.String)>

Aplica-se a

OpenFileDescriptor(Uri, String, CancellationSignal)