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

Definición

Abra y devuelva el 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

documento que se va a devolver.

mode
String

modo con el que se va a abrir, como "r", "w" o "rw".

signal
CancellationSignal

utilizado por el autor de la llamada para indicar si se debe cancelar la solicitud. Puede ser null.

Devoluciones

Atributos

Excepciones

Comentarios

Abra y devuelva el documento solicitado.

El proveedor debe devolver un valor confiable ParcelFileDescriptor para detectar cuándo el autor de la llamada remota ha terminado de leer o escribir el documento.

El modo "r" siempre debe ser compatible. El proveedor debe iniciarse UnsupportedOperationException si no se admite el modo de paso. Puede devolver un par de canalización o socket si el modo es exclusivamente "r" o "w", pero los modos complejos como "rw" implican un archivo normal en el disco que admite la búsqueda.

Si bloquea al descargar contenido, debe comprobar CancellationSignal#isCanceled() periódicamente que anule las solicitudes abiertas abandonadas.

Java documentación para android.provider.DocumentsProvider.openDocument(java.lang.String, java.lang.String, android.os.CancellationSignal).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a

Consulte también