DocumentsProvider.QuerySearchDocuments メソッド

[Android.Runtime.Register("querySearchDocuments", "(Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;)Landroid/database/Cursor;", "GetQuerySearchDocuments_Ljava_lang_String_Ljava_lang_String_arrayLjava_lang_String_Handler")]
public virtual Android.Database.ICursor? QuerySearchDocuments(string? rootId, string? query, string[]? projection);

[<Android.Runtime.Register("querySearchDocuments", "(Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;)Landroid/database/Cursor;", "GetQuerySearchDocuments_Ljava_lang_String_Ljava_lang_String_arrayLjava_lang_String_Handler")>]
abstract member QuerySearchDocuments : string * string * string[] -> Android.Database.ICursor
override this.QuerySearchDocuments : string * string * string[] -> Android.Database.ICursor

パラメーター

返品

属性

RegisterAttribute

例外

注釈

要求されたルートの指定されたクエリに一致するドキュメントを返します。 返されるドキュメントは、関連性で降順に並べ替える必要があります。 ドキュメントをクエリ文字列と照合する方法は、各プロバイダーに残された実装の詳細ですが、少なくとも Document#COLUMN_DISPLAY_NAME 大文字と小文字を区別せずに照合することをお勧めします。

プロバイダーがクラウドベースで、ローカルにキャッシュまたはピン留めされたデータがある場合は、すぐにローカル データを返し、カーソルに DocumentsContract#EXTRA_LOADING 設定して、追加のデータをフェッチしていることを示します。 その後、ネットワーク データが使用可能になったら、変更通知を送信して再クエリをトリガーし、完全な内容を返すことができます。

変更通知をサポートするには、DocumentsContract#buildSearchDocumentsUri(String, String, String)などの関連する URI を使用してCursor#setNotificationUri(ContentResolver, Uri)する必要があります。 その後、その URI で ContentResolver#notifyChange(Uri, android.database.ContentObserver, boolean) を呼び出して、変更通知を送信できます。

Javaドキュメント。

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

こちらもご覧ください

• ExtraLoading
• ExtraInfo
• ExtraError

[Android.Runtime.Register("querySearchDocuments", "(Ljava/lang/String;[Ljava/lang/String;Landroid/os/Bundle;)Landroid/database/Cursor;", "GetQuerySearchDocuments_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_Bundle_Handler", ApiSince=29)]
public virtual Android.Database.ICursor? QuerySearchDocuments(string rootId, string[]? projection, Android.OS.Bundle queryArgs);

[<Android.Runtime.Register("querySearchDocuments", "(Ljava/lang/String;[Ljava/lang/String;Landroid/os/Bundle;)Landroid/database/Cursor;", "GetQuerySearchDocuments_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_Bundle_Handler", ApiSince=29)>]
abstract member QuerySearchDocuments : string * string[] * Android.OS.Bundle -> Android.Database.ICursor
override this.QuerySearchDocuments : string * string[] * Android.OS.Bundle -> Android.Database.ICursor

パラメーター

返品

カーソルに検索結果が含まれています。 結果の準備中に任意のQUERY_ARG_* 値が受け入れられたとき、Cursor extras BundleにContentResolver#EXTRA_HONORED_ARGSを含めます。

属性

RegisterAttribute

注釈

要求されたルートの指定されたクエリに一致するドキュメントを返します。 返されるドキュメントは、関連性で降順に並べ替える必要があります。 ドキュメントをクエリ文字列と照合する方法は、各プロバイダーに残された実装の詳細ですが、少なくとも Document#COLUMN_DISPLAY_NAME 大文字と小文字を区別せずに照合することをお勧めします。

プロバイダーがクラウドベースで、ローカルにキャッシュまたはピン留めされたデータがある場合は、すぐにローカル データを返し、カーソルに DocumentsContract#EXTRA_LOADING 設定して、追加のデータをフェッチしていることを示します。 その後、ネットワーク データが使用可能になったら、変更通知を送信して再クエリをトリガーし、完全な内容を返すことができます。

変更通知をサポートするには、DocumentsContract#buildSearchDocumentsUri(String, String, String)などの関連する URI を使用してCursor#setNotificationUri(ContentResolver, Uri)する必要があります。 その後、その URI で ContentResolver#notifyChange(Uri, android.database.ContentObserver, boolean) を呼び出して、変更通知を送信できます。

Javaドキュメント。

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