DocumentsProvider.OpenDocument(String, String, CancellationSignal) Método

Definição

Namespace:
Android.Provider
Assembly:
Mono.Android.dll

Abra e retorne o documento solicitado.

[Android.Runtime.Register("openDocument", "(Ljava/lang/String;Ljava/lang/String;Landroid/os/CancellationSignal;)Landroid/os/ParcelFileDescriptor;", "GetOpenDocument_Ljava_lang_String_Ljava_lang_String_Landroid_os_CancellationSignal_Handler")]
public abstract Android.OS.ParcelFileDescriptor? OpenDocument(string? documentId, string? mode, Android.OS.CancellationSignal? signal);
[<Android.Runtime.Register("openDocument", "(Ljava/lang/String;Ljava/lang/String;Landroid/os/CancellationSignal;)Landroid/os/ParcelFileDescriptor;", "GetOpenDocument_Ljava_lang_String_Ljava_lang_String_Landroid_os_CancellationSignal_Handler")>]
abstract member OpenDocument : string * string * Android.OS.CancellationSignal -> Android.OS.ParcelFileDescriptor

Parâmetros

documentId
String

o documento a ser retornado.

mode
String

o modo com o qual abrir, como 'r', 'w' ou 'rw'.

signal
CancellationSignal

usado pelo chamador para sinalizar se a solicitação deve ser cancelada. Pode ser nulo.

Retornos

ParcelFileDescriptor
Atributos
RegisterAttribute

Exceções

FileNotFoundException

Comentários

Abra e retorne o documento solicitado.

Seu provedor deve retornar um valor confiável ParcelFileDescriptor para detectar quando o chamador remoto terminar de ler ou gravar o documento.

O modo "r" sempre deve ter suporte. O provedor deverá ser gerado UnsupportedOperationException se não houver suporte para o modo de passagem. Você poderá retornar um par de pipes ou soquetes se o modo for exclusivamente "r" ou "w", mas modos complexos como "rw" implicam um arquivo normal no disco que dá suporte à busca.

Se você bloquear durante o download do conteúdo, deverá verificar CancellationSignal#isCanceled() periodicamente para anular solicitações abertas abandonadas.

Java documentação para android.provider.DocumentsProvider.openDocument(java.lang.String, java.lang.String, android.os.CancellationSignal).

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

Confira também