Language

DocumentsProvider.QuerySearchDocuments メソッド

定義

オーバーロード

Name 説明
QuerySearchDocuments(String, String[], Bundle, CancellationSignal)

要求されたディレクトリの指定されたクエリに一致するドキュメントを返します。

QuerySearchDocuments(String, String, String[], CancellationSignal)

要求されたディレクトリの指定されたクエリに一致するドキュメントを返します。

QuerySearchDocuments(String, String, String[])

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

QuerySearchDocuments(String, String[], Bundle)

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

QuerySearchDocuments(String, String[], Bundle, CancellationSignal)

要求されたディレクトリの指定されたクエリに一致するドキュメントを返します。

[Android.Runtime.Register("querySearchDocuments", "(Ljava/lang/String;[Ljava/lang/String;Landroid/os/Bundle;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "GetQuerySearchDocuments_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_Bundle_Landroid_os_CancellationSignal_Handler", ApiSince=37)]
public virtual Android.Database.ICursor? QuerySearchDocuments(string parentDocumentId, string[]? projection, Android.OS.Bundle queryArgs, Android.OS.CancellationSignal? signal);
[<Android.Runtime.Register("querySearchDocuments", "(Ljava/lang/String;[Ljava/lang/String;Landroid/os/Bundle;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "GetQuerySearchDocuments_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_Bundle_Landroid_os_CancellationSignal_Handler", ApiSince=37)>]
abstract member QuerySearchDocuments : string * string[] * Android.OS.Bundle * Android.OS.CancellationSignal -> Android.Database.ICursor
override this.QuerySearchDocuments : string * string[] * Android.OS.Bundle * Android.OS.CancellationSignal -> Android.Database.ICursor

パラメーター

parentDocumentId
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。

signal
CancellationSignal

要求を取り消す必要があるかどうかを通知するために呼び出し元によって使用されます。 null を指定できます。

返品

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

属性

注釈

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

このメソッドは、サブツリー レベルの検索に対して呼び出されます。 Document.FLAG_SUPPORTS_SUBTREE_SEARCHをアドバタイズするには、特定のディレクトリが必要です。

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

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

android.provider.DocumentsProvider.querySearchDocumentsの Android リファレンス。

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

適用対象

QuerySearchDocuments(String, String, String[], CancellationSignal)

要求されたディレクトリの指定されたクエリに一致するドキュメントを返します。

[Android.Runtime.Register("querySearchDocuments", "(Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "GetQuerySearchDocuments_Ljava_lang_String_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_CancellationSignal_Handler", ApiSince=37)]
public virtual Android.Database.ICursor? QuerySearchDocuments(string parentDocumentId, string query, string[]? projection, Android.OS.CancellationSignal? signal);
[<Android.Runtime.Register("querySearchDocuments", "(Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "GetQuerySearchDocuments_Ljava_lang_String_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_CancellationSignal_Handler", ApiSince=37)>]
abstract member QuerySearchDocuments : string * string * string[] * Android.OS.CancellationSignal -> Android.Database.ICursor
override this.QuerySearchDocuments : string * string * string[] * Android.OS.CancellationSignal -> Android.Database.ICursor

パラメーター

parentDocumentId
String

検索するディレクトリ。

query
String

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

projection
String[]

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

signal
CancellationSignal

要求を取り消す必要があるかどうかを通知するために呼び出し元によって使用されます。 null を指定できます。

返品

属性

注釈

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

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

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

android.provider.DocumentsProvider.querySearchDocumentsの Android リファレンス。

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

適用対象

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 大文字と小文字を区別せずに照合することをお勧めします。

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

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

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。

返品

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

属性

注釈

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

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

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

Javaドキュメント。

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

適用対象