DocumentsProvider.QuerySearchDocuments メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
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)
して、変更通知を送信できます。
このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。
こちらもご覧ください
適用対象
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
.
戻り値
カーソルに検索結果が含まれています。 結果の準備中に任意のCursor
QUERY_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)
して、変更通知を送信できます。
このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。