ContentResolver.Query 方法

定義

命名空間:: Android.Content

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
Query(Uri, String[], Bundle, CancellationSignal)	查詢給定的 URI，回傳對結果集的 A `Cursor` 並支援消去。
Query(Uri, String[], String, String[], String)	查詢給定的 URI，並回傳對結果集的 a `Cursor` 。
Query(Uri, String[], String, String[], String, CancellationSignal)	查詢給定的 URI，回傳結果集上的 URI `Cursor` ，並可選擇性地支援消去。

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

查詢給定的 URI，回傳對結果集的 A 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

取消正在進行的操作的訊號，若無則為空。若操作被取消， OperationCanceledException 則執行查詢時會拋出。

傳回

ICursor

一個游標物件，位於第一個條目之前。如果底層內容提供者回歸null，或當機，可能會回來null。

屬性: RegisterAttribute

備註

查詢給定的 URI，回傳對結果集的 A Cursor 並支援消去。

為了達到最佳效能，來電者應遵循以下指引：

<li>提供明確的投影，以防止從儲存裝置讀取不會被使用的資料。

提供者必須在結果集準備過程中，透過在額外欄位Cursor中包含相應的參數鍵Bundle來識別哪些QUERY_ARG_SORT*參數被尊重。如需詳細資訊，請參閱 #EXTRA_HONORED_ARGS。

Java 文件 android.content.ContentResolver.query(android.net.Uri, java.lang.String[], android.os.Bundle, android.os.CancellationSignal)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

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

查詢給定的 URI，並回傳對結果集的 a 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

一個游標物件，位於第一個條目之前。如果底層內容提供者回歸null，或當機，可能會回來null。

屬性: RegisterAttribute

備註

查詢給定的 URI，並回傳對結果集的 a Cursor 。

為了達到最佳效能，呼叫者應遵循以下指引：<ul><li>提供明確的投影，以防止從不會被使用的儲存資料讀取。</li><li>使用問號參數標記，如「phone=？」而非參數中 selection 明確的值，這樣只要差一點的查詢就會被快取時視為相同值。</li></ul>

Java 文件 android.content.ContentResolver.query(android.net.Uri, java.lang.String[], java.lang.String, java.lang.String[], java.lang.String)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

另請參閱

ICursor

適用於

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

查詢給定的 URI，回傳結果集上的 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

取消正在進行的操作的訊號，若無則為空。若操作被取消， OperationCanceledException 則執行查詢時會拋出。

傳回

ICursor

一個游標物件，位於第一個條目之前。如果底層內容提供者回歸null，或當機，可能會回來null。

屬性: RegisterAttribute

備註

查詢給定的 URI，回傳結果集上的 URI Cursor ，並可選擇性地支援消去。

Java 文件 android.content.ContentResolver.query(android.net.Uri, java.lang.String[], java.lang.String, java.lang.String[], java.lang.String, android.os.CancellationSignal)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

另請參閱

ICursor

適用於