DocumentsProvider.OpenDocument(String, String, CancellationSignal) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
打開並歸還所要求的文件。
[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 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
另請參閱
- <xref:Android.OS.ParcelFileDescriptor.Open(Java.IO.File%2c+Android.OS.ParcelFileMode%2c+Android.OS.ParcelFileMode%2c+Android.OS.ParcelFileMode)>
- CreateReliablePipe()
- CreateReliableSocketPair()
- ParseMode(String)