ContentResolver.Query メソッド

定義

名前空間:

Android.Content

アセンブリ:

Mono.Android.dll

オーバーロード

名前	説明
Query(Uri, String[], Bundle, CancellationSignal)	指定された URI に対してクエリを実行し、キャンセルをサポートする結果セットに対して Cursor を返します。
Query(Uri, String[], String, String[], String)	指定された URI に対してクエリを実行し、結果セットに対して Cursor を返します。
Query(Uri, String[], String, String[], String, CancellationSignal)	指定された URI に対してクエリを実行し、取り消しのサポートを省略可能な結果セットに対して Cursor を返します。

Query(Uri, String[], Bundle, CancellationSignal)

指定された URI に対してクエリを実行し、キャンセルをサポートする結果セットに対して Cursor を返します。

[Android.Runtime.Register("query", "(Landroid/net/Uri;[Ljava/lang/String;Landroid/os/Bundle;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "", ApiSince=26)]
public Android.Database.ICursor? Query(Android.Net.Uri uri, string[]? projection, Android.OS.Bundle? queryArgs, Android.OS.CancellationSignal? cancellationSignal);

[<Android.Runtime.Register("query", "(Landroid/net/Uri;[Ljava/lang/String;Landroid/os/Bundle;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "", ApiSince=26)>]
member this.Query : Android.Net.Uri * string[] * Android.OS.Bundle * Android.OS.CancellationSignal -> Android.Database.ICursor

パラメーター

uri

Uri

取得するコンテンツの content:// スキームを使用する URI。

projection

String[]

返す列の一覧。 null を渡すとすべての列が返されます。これは非効率的です。

queryArgs

Bundle

操作に必要な追加情報を含むバンドル。 引数には、 ContentResolver#QUERY_ARG_SQL_LIMITなどの SQL スタイルの引数を含めることができますが、各プロバイダーのドキュメントでは、サポートする引数が示されることに注意してください。

cancellationSignal

CancellationSignal

進行中の操作を取り消すシグナル。存在しない場合は null。 操作が取り消されると、クエリの実行時に OperationCanceledException がスローされます。

返品

ICursor

最初のエントリの前に配置される Cursor オブジェクト。 基になるコンテンツ プロバイダーがnullを返した場合、またはクラッシュした場合、nullを返す場合があります。

属性

RegisterAttribute

注釈

指定された URI に対してクエリを実行し、キャンセルをサポートする結果セットに対して Cursor を返します。

パフォーマンスを最大限に高めるには、呼び出し元は次のガイドラインに従う必要があります。

<li>明示的なプロジェクションを実行して、使用されないストレージからデータを読み取らないようにします。

プロバイダーは、結果セットの準備中に受け入れられていたQUERY_ARG_SORT* 引数を、 Cursor の追加 Bundleにそれぞれの引数キーを含めることで識別する必要があります。 詳細については、#EXTRA_HONORED_ARGS を参照してください。

Javaドキュメント。

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

Query(Uri, String[], String, String[], String)

指定された URI に対してクエリを実行し、結果セットに対して Cursor を返します。

[Android.Runtime.Register("query", "(Landroid/net/Uri;[Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;)Landroid/database/Cursor;", "")]
public Android.Database.ICursor? Query(Android.Net.Uri uri, string[]? projection, string? selection, string[]? selectionArgs, string? sortOrder);

[<Android.Runtime.Register("query", "(Landroid/net/Uri;[Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;)Landroid/database/Cursor;", "")>]
member this.Query : Android.Net.Uri * string[] * string * string[] * string -> Android.Database.ICursor

パラメーター

uri

Uri

取得するコンテンツの content:// スキームを使用する URI。

projection

String[]

返す列の一覧。 null を渡すとすべての列が返されます。これは非効率的です。

selection

String

返す行を宣言するフィルター。SQL WHERE 句として書式設定されます (WHERE 自体は除きます)。 null を渡すと、指定された URI のすべての行が返されます。

selectionArgs

String[]

選択範囲に ?s を含めることができます。これは、選択範囲に表示される順序で selectionArgs の値に置き換えられます。 値は文字列としてバインドされます。

sortOrder

String

SQL ORDER BY 句として書式設定された行を並べ替える方法 (ORDER BY 自体を除く)。 null を渡すと、既定の並べ替え順序が使用され、順序が指定されていない可能性があります。

返品

ICursor

最初のエントリの前に配置される Cursor オブジェクト。 基になるコンテンツ プロバイダーがnullを返した場合、またはクラッシュした場合、nullを返す場合があります。

属性

RegisterAttribute

注釈

指定された URI に対してクエリを実行し、結果セットに対して Cursor を返します。

最適なパフォーマンスを得るために、呼び出し元は次のガイドラインに従う必要があります。 <ul><li>provide an explicit projection, to prevent reading data from storage that't be be used.</li><li> 'phone=?' などの疑問符パラメーター マーカーを使用します selection パラメーターの明示的な値ではなく、これらの値によってのみ異なるクエリがキャッシュ目的で同じとして認識されるようにします</li></ul>

Javaドキュメント。

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

こちらもご覧ください

• ICursor

Query(Uri, String[], String, String[], String, CancellationSignal)

指定された URI に対してクエリを実行し、取り消しのサポートを省略可能な結果セットに対して Cursor を返します。

[Android.Runtime.Register("query", "(Landroid/net/Uri;[Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "")]
public Android.Database.ICursor? Query(Android.Net.Uri uri, string[]? projection, string? selection, string[]? selectionArgs, string? sortOrder, Android.OS.CancellationSignal? cancellationSignal);

[<Android.Runtime.Register("query", "(Landroid/net/Uri;[Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "")>]
member this.Query : Android.Net.Uri * string[] * string * string[] * string * Android.OS.CancellationSignal -> Android.Database.ICursor

パラメーター

uri

Uri

取得するコンテンツの content:// スキームを使用する URI。

projection

String[]

返す列の一覧。 null を渡すとすべての列が返されます。これは非効率的です。

selection

String

返す行を宣言するフィルター。SQL WHERE 句として書式設定されます (WHERE 自体は除きます)。 null を渡すと、指定された URI のすべての行が返されます。

selectionArgs

String[]

選択範囲に ?s を含めることができます。これは、選択範囲に表示される順序で selectionArgs の値に置き換えられます。 値は文字列としてバインドされます。

sortOrder

String

SQL ORDER BY 句として書式設定された行を並べ替える方法 (ORDER BY 自体を除く)。 null を渡すと、既定の並べ替え順序が使用され、順序が指定されていない可能性があります。

cancellationSignal

CancellationSignal

進行中の操作を取り消すシグナル。存在しない場合は null。 操作が取り消されると、クエリの実行時に OperationCanceledException がスローされます。

返品

ICursor

最初のエントリの前に配置される Cursor オブジェクト。 基になるコンテンツ プロバイダーがnullを返した場合、またはクラッシュした場合、nullを返す場合があります。

属性

RegisterAttribute

注釈

指定された URI に対してクエリを実行し、取り消しのサポートを省略可能な結果セットに対して Cursor を返します。

最適なパフォーマンスを得るために、呼び出し元は次のガイドラインに従う必要があります。 <ul><li>provide an explicit projection, to prevent reading data from storage that't be be used.</li><li> 'phone=?' などの疑問符パラメーター マーカーを使用します selection パラメーターの明示的な値ではなく、これらの値によってのみ異なるクエリがキャッシュ目的で同じとして認識されるようにします</li></ul>

Javaドキュメント。

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

こちらもご覧ください

• ICursor