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
URI，使用 content:// 配置來擷取內容。
- projection
- String[]
要傳回之資料行的清單。 傳遞 Null 會傳回所有數據行，其效率不佳。
- queryArgs
- Bundle
套件組合，其中包含作業所需的其他資訊。 自變數可能包含 SQL 樣式自變數，例如 ContentResolver#QUERY_ARG_SQL_LIMIT，但請注意，每個個別提供者的檔都會指出它們支援的自變數。
- cancellationSignal
- CancellationSignal
取消進行中作業的訊號，如果沒有則為 null。
如果取消作業，則會 OperationCanceledException 在執行查詢時擲回。
傳回
Cursor 對象，位於第一個專案之前。 如果基礎內容提供者傳null回 ，或當機，可能會傳回 null 。
- 屬性
備註
查詢指定的 URI，並 Cursor 透過支援取消的結果集傳回 。
為了獲得最佳效能，呼叫端應遵循下列指導方針：
<li>提供明確的投影，以防止從不會使用的記憶體讀取數據。
提供者必須在準備結果集時識別哪些QUERY_ARG_SORT* 自變數，方法是在額外的 Bundle中包含Cursor個別的自變數索引鍵。 如需詳細資訊，請參閱#EXTRA_HONORED_ARGS。
此頁面的部分是根據 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 的值所取代，其順序會依選取範圍中出現的順序來取代。 這些值會系結為 Strings。
- sortOrder
- String
如何排序數據列，格式化為 SQL ORDER BY 子句（不包括 ORDER BY 本身）。 傳遞 Null 會使用預設排序順序，可能未排序。
傳回
Cursor 對象，位於第一個專案之前。 如果基礎內容提供者傳null回 ，或當機，可能會傳回 null 。
- 屬性
備註
查詢指定的 URI，並透過結果集傳 Cursor 回 。
為了獲得最佳效能，呼叫端應遵循下列指導方針：<ul<>li>提供明確的投影，以防止從不會使用的記憶體讀取數據。</li li><>使用問號參數標記，例如 'phone=？' 而不是 參數中的 selection 明確值，因此只有這些值不同的查詢會辨識為與快取目的相同的查詢。</li></ul>
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 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
URI，使用 content:// 配置來擷取內容。
- projection
- String[]
要傳回之資料行的清單。 傳遞 Null 會傳回所有數據行，其效率不佳。
- selection
- String
篩選條件，宣告要傳回的數據列，格式化為 SQL WHERE 子句（不包括 WHERE 本身）。 傳遞 null 會傳回指定 URI 的所有資料列。
- selectionArgs
- String[]
您可以在選取範圍中包含 ？s，這會由 selectionArgs 的值所取代，其順序會依選取範圍中出現的順序來取代。 這些值會系結為 Strings。
- 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 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。