ContentResolver.Query メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
Query(Uri, String[], Bundle, CancellationSignal) |
指定された URI に対してクエリを実行し |
Query(Uri, String[], String, String[], String) |
指定された URI に対してクエリを実行し |
Query(Uri, String[], String, String[], String, CancellationSignal) |
指定された URI に対してクエリを実行し、取り消し |
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
操作に必要な追加情報を含むバンドル。 引数には SQL スタイルの引数 (例: ContentResolver#QUERY_ARG_SQL_LIMIT
) を含めることができますが、各プロバイダーのドキュメントでは、サポートする引数が示されることに注意してください。
- cancellationSignal
- CancellationSignal
進行中の操作を取り消すシグナル。存在しない場合は null。
操作が取り消されると、 OperationCanceledException
クエリの実行時にスローされます。
戻り値
最初のエントリの前に配置される Cursor オブジェクト。 基になるコンテンツ プロバイダーが返 null
された場合、またはクラッシュした null
場合に返される場合があります。
- 属性
注釈
指定された URI に対してクエリを実行し Cursor
、キャンセルをサポートする結果セットを返します。
パフォーマンスを最大限に高めるには、呼び出し元は次のガイドラインに従う必要があります。
<li>明示的なプロジェクションを指定して、使用されないストレージからデータを読み取らないようにします。
プロバイダーは、結果セットの準備中に受け入れられていたQUERY_ARG_SORT* 引数を識別する必要があります。これには、各引数キーを Cursor
extras に含めます Bundle
。 詳細については、#EXTRA_HONORED_ARGS
を参照してください。
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。
適用対象
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 を渡すと、既定の並べ替え順序が使用され、順序が指定されていない可能性があります。
戻り値
最初のエントリの前に配置される Cursor オブジェクト。 基になるコンテンツ プロバイダーが返 null
された場合、またはクラッシュした null
場合に返される場合があります。
- 属性
注釈
指定された URI に対してクエリを実行し Cursor
、結果セットを返します。
最適なパフォーマンスを得るために、呼び出し元は次のガイドライン<に従う必要があります。ul><li>明示的なプロジェクションを指定して、使用されないストレージからデータを読み取らないようにします。</li li><>'phone=?' などの疑問符パラメーター マーカーを使用する パラメーター内 selection
の明示的な値の代わりに、これらの値によってのみ異なるクエリがキャッシュ目的で同じとして認識されるようにします。</li></ul>
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。
こちらもご覧ください
適用対象
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
クエリの実行時にスローされます。
戻り値
最初のエントリの前に配置される Cursor オブジェクト。 基になるコンテンツ プロバイダーが返 null
された場合、またはクラッシュした null
場合に返される場合があります。
- 属性
注釈
指定された URI に対してクエリを実行し、取り消し Cursor
をオプションでサポートする結果セットを返します。
最適なパフォーマンスを得るために、呼び出し元は次のガイドライン<に従う必要があります。ul><li>明示的なプロジェクションを指定して、使用されないストレージからデータを読み取らないようにします。</li li><>'phone=?' などの疑問符パラメーター マーカーを使用する パラメーター内 selection
の明示的な値の代わりに、これらの値によってのみ異なるクエリがキャッシュ目的で同じとして認識されるようにします。</li></ul>
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。