次の方法で共有


DocumentsProvider.QuerySearchDocuments メソッド

定義

オーバーロード

QuerySearchDocuments(String, String, String[])

要求されたルートで指定されたクエリに一致するドキュメントを返します。

QuerySearchDocuments(String, String[], Bundle)

要求されたルートで指定されたクエリに一致するドキュメントを返します。

QuerySearchDocuments(String, String, String[])

要求されたルートで指定されたクエリに一致するドキュメントを返します。

[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

パラメーター

rootId
String

検索するルート。

query
String

ドキュメントを照合する文字列。

projection
String[]

カーソルに配置する列の Document 一覧。 サポートされているすべての列を含める必要がある場合 null

戻り値

属性

例外

注釈

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

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

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

android.provider.DocumentsProvider.querySearchDocuments(java.lang.String, java.lang.String, java.lang.String[])Java ドキュメント。

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

こちらもご覧ください

適用対象

QuerySearchDocuments(String, String[], Bundle)

要求されたルートで指定されたクエリに一致するドキュメントを返します。

[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

パラメーター

rootId
String

検索するルート。

projection
String[]

カーソルに配置する列の Document 一覧。 サポートされているすべての列を含める必要がある場合 null

queryArgs
Bundle

クエリ引数。 DocumentsContract#QUERY_ARG_EXCLUDE_MEDIA, DocumentsContract#QUERY_ARG_DISPLAY_NAME, DocumentsContract#QUERY_ARG_MIME_TYPES, DocumentsContract#QUERY_ARG_FILE_SIZE_OVER, DocumentsContract#QUERY_ARG_LAST_MODIFIED_AFTER.

戻り値

カーソルに検索結果が含まれています。 結果の準備中に任意のCursorQUERY_ARG_* 値が優先された場合は、余分Bundleな値に含めますContentResolver#EXTRA_HONORED_ARGS

属性

注釈

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

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

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

android.provider.DocumentsProvider.querySearchDocuments(java.lang.String, java.lang.String[], android.os.Bundle)Java ドキュメント。

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

適用対象