Langue

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

Définition

Espace de noms:
Android.Provider
Assembly:
Mono.Android.dll

Ouvrez et retournez le document demandé.

[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

Paramètres

documentId
String

document à retourner.

mode
String

le mode à ouvrir avec, par exemple « r », « w » ou « rw ».

signal
CancellationSignal

utilisé par l’appelant pour signaler si la demande doit être annulée. Peut être null.

Retours

ParcelFileDescriptor
Attributs
RegisterAttribute

Exceptions

FileNotFoundException

Remarques

Ouvrez et retournez le document demandé.

Votre fournisseur doit retourner une valeur fiable ParcelFileDescriptor pour détecter quand l’appelant distant a terminé la lecture ou l’écriture du document.

Le mode « r » doit toujours être pris en charge. Le fournisseur doit lever UnsupportedOperationException si le mode de passage n’est pas pris en charge. Vous pouvez retourner une paire de canal ou de socket si le mode est exclusivement « r » ou « w », mais les modes complexes tels que « rw » impliquent un fichier normal sur le disque qui prend en charge la recherche.

Si vous bloquez lors du téléchargement du contenu, vous devez vérifier CancellationSignal#isCanceled() régulièrement l’abandon des demandes ouvertes abandonnées.

Documentation Java pour android.provider.DocumentsProvider.openDocument(java.lang.String, java.lang.String, android.os.CancellationSignal).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à

Voir aussi