語言

DocumentsProvider.OpenDocument(String, String, CancellationSignal) 方法

定義

打開並歸還所要求的文件。

[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

參數

documentId
String

要歸還的文件。

mode
String

開場時的模式,如「r」、「w」或「rw」。

signal
CancellationSignal

呼叫者用來表示是否應該取消請求。 可能是 Null。

傳回

屬性

例外狀況

備註

打開並歸還所要求的文件。

你的服務提供者應該回傳一個可靠 ParcelFileDescriptor 訊息,以偵測遠端來電者是否完成閱讀或撰寫文件。

模式「r」應該永遠被支援。 如果不支援傳遞模式,提供者應該會丟出 UnsupportedOperationException 。 如果模式完全是「r」或「w」,你可以回傳管線或套接字對,但像「rw」這類複雜模式則暗示磁碟上有一個支援尋道的普通檔案。

如果你在下載內容時封鎖了,應該定期檢查 CancellationSignal#isCanceled() 是否會中止那些已放棄的未完成請求。

的 android.provider.DocumentsProvider.openDocument(java.lang.String, java.lang.String, android.os.CancellationSignal)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於

另請參閱