DocumentsProvider.OpenDocument(String, String, CancellationSignal) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.
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
- <xref:Android.OS.ParcelFileDescriptor.Open(Java.IO.File%2c+Android.OS.ParcelFileMode%2c+Android.OS.ParcelFileMode%2c+Android.OS.ParcelFileMode)>
- CreateReliablePipe()
- CreateReliableSocketPair()
- ParseMode(String)