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() を定期的にチェックして、破棄された開いている要求を中止する必要があります。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

こちらもご覧ください