DocumentsProvider.OpenDocument(String, String, CancellationSignal) Methode

Definition

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

Öffnen sie das angeforderte Dokument, und geben Sie es zurück.

[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

Parameter

documentId
String

das zurückzugebende Dokument.

mode
String

der Modus, der geöffnet werden soll, z. B. "r", "w" oder "rw".

signal
CancellationSignal

wird vom Anrufer verwendet, um zu signalisieren, ob die Anforderung abgebrochen werden soll. Kann null sein.

Gibt zurück

ParcelFileDescriptor
Attribute
RegisterAttribute

Ausnahmen

FileNotFoundException

Hinweise

Öffnen sie das angeforderte Dokument, und geben Sie es zurück.

Ihr Anbieter sollte eine zuverlässige ParcelFileDescriptor Erkennung zurückgeben, wenn der Remoteanrufer das Lesen oder Schreiben des Dokuments abgeschlossen hat.

Modus "r" sollte immer unterstützt werden. Der Anbieter sollte ausgelöst werden UnsupportedOperationException , wenn der Übergabemodus nicht unterstützt wird. Sie können ein Pipe- oder Socketpaar zurückgeben, wenn der Modus ausschließlich "r" oder "w" ist, aber komplexe Modi wie "rw" bedeuten eine normale Datei auf dem Datenträger, die die Suche unterstützt.

Wenn Sie beim Herunterladen von Inhalten blockieren, sollten Sie regelmäßig überprüfen CancellationSignal#isCanceled() , ob abgebrochene offene Anforderungen abgebrochen werden.

Java Dokumentation für android.provider.DocumentsProvider.openDocument(java.lang.String, java.lang.String, android.os.CancellationSignal).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

Weitere Informationen