DocumentsProvider.QueryChildDocuments メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 名前 | 説明 |
|---|---|
| QueryChildDocuments(String, String[], Bundle) |
要求されたディレクトリに含まれる子ドキュメントを返すには、このメソッドをオーバーライドします。 |
| QueryChildDocuments(String, String[], String) |
要求されたディレクトリに含まれている子ドキュメントを返します。 |
QueryChildDocuments(String, String[], Bundle)
要求されたディレクトリに含まれる子ドキュメントを返すには、このメソッドをオーバーライドします。
[Android.Runtime.Register("queryChildDocuments", "(Ljava/lang/String;[Ljava/lang/String;Landroid/os/Bundle;)Landroid/database/Cursor;", "GetQueryChildDocuments_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_Bundle_Handler", ApiSince=26)]
public virtual Android.Database.ICursor? QueryChildDocuments(string? parentDocumentId, string[]? projection, Android.OS.Bundle? queryArgs);
[<Android.Runtime.Register("queryChildDocuments", "(Ljava/lang/String;[Ljava/lang/String;Landroid/os/Bundle;)Landroid/database/Cursor;", "GetQueryChildDocuments_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_Bundle_Handler", ApiSince=26)>]
abstract member QueryChildDocuments : string * string[] * Android.OS.Bundle -> Android.Database.ICursor
override this.QueryChildDocuments : string * string[] * Android.OS.Bundle -> Android.Database.ICursor
パラメーター
- parentDocumentId
- String
子を返すディレクトリ。
- projection
- String[]
カーソルに配置 Document 列の一覧。 サポートされているすべての列 null 含める必要がある場合。
- queryArgs
- Bundle
並べ替え情報またはその他の引数を含むバンドルは、プロバイダーにとって役立ちます。 並べ替え情報が使用できない場合は、既定の並べ替えが使用され、順序が指定されていない可能性があります。 詳細については、ContentResolver#QUERY_ARG_SORT_COLUMNS を参照してください。
返品
- 属性
注釈
要求されたディレクトリに含まれる子ドキュメントを返すには、このメソッドをオーバーライドします。 これは直下の子孫のみを返す必要があります。
プロバイダーがクラウドベースで、データがローカルにキャッシュされている場合は、すぐにローカル データを返し、Cursor extras に DocumentsContract#EXTRA_LOADING 設定して、追加のデータをまだフェッチしていることを示します。 その後、ネットワーク データが使用可能になったら、変更通知を送信して再クエリをトリガーし、完全な内容を返すことができます。 カーソルを追加で返すには、 Cursor#getExtras()を拡張してオーバーライドする必要があります。
変更通知をサポートするには、DocumentsContract#buildChildDocumentsUri(String, String)などの関連する URI を使用してCursor#setNotificationUri(ContentResolver, Uri)する必要があります。 その後、その URI で ContentResolver#notifyChange(Uri, android.database.ContentObserver, boolean) を呼び出して、変更通知を送信できます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
QueryChildDocuments(String, String[], String)
要求されたディレクトリに含まれている子ドキュメントを返します。
[Android.Runtime.Register("queryChildDocuments", "(Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;)Landroid/database/Cursor;", "GetQueryChildDocuments_Ljava_lang_String_arrayLjava_lang_String_Ljava_lang_String_Handler")]
public abstract Android.Database.ICursor? QueryChildDocuments(string? parentDocumentId, string[]? projection, string? sortOrder);
[<Android.Runtime.Register("queryChildDocuments", "(Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;)Landroid/database/Cursor;", "GetQueryChildDocuments_Ljava_lang_String_arrayLjava_lang_String_Ljava_lang_String_Handler")>]
abstract member QueryChildDocuments : string * string[] * string -> Android.Database.ICursor
パラメーター
- parentDocumentId
- String
子を返すディレクトリ。
- projection
- String[]
カーソルに配置 Document 列の一覧。 サポートされているすべての列 null 含める必要がある場合。
- sortOrder
- String
SQL ORDER BY 句として書式設定された行を並べ替える方法 (ORDER BY 自体を除く)。
nullを渡すと、既定の並べ替え順序が使用され、順序が指定されていない可能性があります。 この順序付けは、ネットワークからデータをフェッチする方法に優先順位を付けるために使用できるヒントですが、UI では常に特定の順序が適用される場合があります。
返品
- 属性
例外
注釈
要求されたディレクトリに含まれている子ドキュメントを返します。 ツリーを再帰的に探索するために追加のクエリが発行されるため、これは直下の子孫のみを返す必要があります。
android.os.Build.VERSION_CODES#O以上を対象とするアプリは、#queryChildDocuments(String, String[], Bundle)をオーバーライドする必要があります。
プロバイダーがクラウドベースで、ローカルにキャッシュまたはピン留めされたデータがある場合は、すぐにローカル データを返し、カーソルに DocumentsContract#EXTRA_LOADING 設定して、追加のデータをフェッチしていることを示します。 その後、ネットワーク データが使用可能になったら、変更通知を送信して再クエリをトリガーし、完全な内容を返すことができます。 カーソルを追加で返すには、 Cursor#getExtras()を拡張してオーバーライドする必要があります。
変更通知をサポートするには、DocumentsContract#buildChildDocumentsUri(String, String)などの関連する URI を使用してCursor#setNotificationUri(ContentResolver, Uri)する必要があります。 その後、その URI で ContentResolver#notifyChange(Uri, android.database.ContentObserver, boolean) を呼び出して、変更通知を送信できます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。