ContentResolver.Query 方法

定义

命名空间:: Android.Content

程序集:: Mono.Android.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

名称	说明
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

URI，使用 content:// 方案检索内容。

projection: String[]

要返回的列的列表。传递 null 将返回所有低效列。

queryArgs: Bundle

包含操作所需的其他信息的捆绑包。参数可能包括 SQL 样式参数，例如 ContentResolver#QUERY_ARG_SQL_LIMIT，但请注意，每个提供程序的文档将指示它们支持的参数。

cancellationSignal: CancellationSignal

取消正在进行的操作的信号;如果没有，则为 null。如果取消了该操作，则在 OperationCanceledException 执行查询时将引发。

ICursor

一个 Cursor 对象，该对象位于第一个条目之前。如果基础内容提供程序返回，或者它崩溃，则可能会返回nullnull。

属性: RegisterAttribute

注解

查询给定的 URI，返回 Cursor 支持取消的结果集。

为了获得最佳性能，调用方应遵循以下准则：

<li>提供显式投影，以防止从不使用的存储中读取数据。

提供程序必须在准备结果集的过程中识别哪些QUERY_ARG_SORT* 参数，方法是在附加Cursor项中包含Bundle相应的参数键。有关详细信息，请参阅#EXTRA_HONORED_ARGS。

适用于 . 的 android.content.ContentResolver.query(android.net.Uri, java.lang.String[], android.os.Bundle, android.os.CancellationSignal)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 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

URI，使用 content:// 方案检索内容。

projection: String[]

要返回的列的列表。传递 null 将返回所有低效列。

selection: String

一个筛选器，声明要返回的行，格式化为 SQL WHERE 子句（不包括 WHERE 本身）。传递 null 将返回给定 URI 的所有行。

selectionArgs: String[]

可以在所选内容中包含？s，这些值将替换为 selectionArgs 中的值，顺序为所选内容中的显示顺序。这些值将绑定为字符串。

sortOrder: String

如何对行进行排序，格式化为 SQL ORDER BY 子句（不包括 ORDER BY 本身）。传递 null 将使用可能未排序的默认排序顺序。

ICursor

一个 Cursor 对象，该对象位于第一个条目之前。如果基础内容提供程序返回，或者它崩溃，则可能会返回nullnull。

属性: RegisterAttribute

注解

查询给定的 URI，返回对结果集的一个 Cursor 值。

为了获得最佳性能，调用方应遵循以下准则：<ul><li>提供显式投影，以防止从不使用的存储中读取数据。</li li><>使用问号参数标记，如“phone=？” 而不是参数中的 selection 显式值，以便仅将这些值不同的查询识别为相同的缓存目的。</li></ul>

适用于 . 的 android.content.ContentResolver.query(android.net.Uri, java.lang.String[], java.lang.String, java.lang.String[], java.lang.String)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

另请参阅

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

URI，使用 content:// 方案检索内容。

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 对象，该对象位于第一个条目之前。如果基础内容提供程序返回，或者它崩溃，则可能会返回nullnull。

属性: RegisterAttribute

注解

查询给定的 URI，返回 Cursor 对取消的可选支持的结果集。

适用于 . 的 android.content.ContentResolver.query(android.net.Uri, java.lang.String[], java.lang.String, java.lang.String[], java.lang.String, android.os.CancellationSignal)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

另请参阅

ICursor

适用于