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 屬性授權中所述的詞彙使用。