ICursor 介面

定義

命名空間:: Android.Database

組件:: Mono.Android.dll

重要

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

此介面提供對資料庫查詢回傳結果集的隨機讀寫存取。

[Android.Runtime.Register("android/database/Cursor", "", "Android.Database.ICursorInvoker")]
public interface ICursor : IDisposable, Java.Interop.IJavaPeerable, Java.IO.ICloseable

[<Android.Runtime.Register("android/database/Cursor", "", "Android.Database.ICursorInvoker")>]
type ICursor = interface
    interface ICloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

衍生: Android.Database.AbstractCursor

Android.Database.CrossProcessCursorWrapper

Android.Database.CursorWrapper

Android.Database.ICrossProcessCursor

Android.Test.Mock.MockCursor

屬性: RegisterAttribute

實作: IJavaObject IJavaPeerable ICloseable IDisposable

備註

此介面提供對資料庫查詢回傳結果集的隨機讀寫存取。

游標實作不一定要同步，因此使用多個執行緒游標的程式碼在使用游標時應自行同步。

實作應該子類別 AbstractCursor。

Java 文件 android.database.Cursor。

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

屬性

名稱	Description
ColumnCount	回傳總欄位數
Count	返回游標上的列數。
Extras	回傳一束額外值。
Handle	取得底層 Android 物件的 JNI 值。 (繼承來源 IJavaObject)
IsAfterLast	回傳游標是否指向最後一列之後的位置。
IsBeforeFirst	返回游標是否指向第一列之前的位置。
IsClosed	若游標關閉，則回傳真
IsFirst	無論游標指向第一列，都會回傳。
IsLast	返回游標是否指向最後一列。
JniIdentityHashCode	回傳包裹實例的 `java.lang.System.identityHashCode()` 值。 (繼承來源 IJavaPeerable)
JniManagedPeerState	管理貴族的狀況。 (繼承來源 IJavaPeerable)
JniPeerMembers	成員存取與召喚支援。 (繼承來源 IJavaPeerable)
NotificationUri	回傳 URI，屆時將傳送此游標資料變更通知，如先前設定的 SetNotificationUri(ContentResolver, Uri)。
PeerReference	回傳JniObjectReference包裹後的 Java 物件實例。 (繼承來源 IJavaPeerable)
Position	回傳游標在列集中的當前位置。
WantsAllOnMoveCalls	onMove（）只有在這個方法回傳為真時才會跨程序呼叫。

方法

名稱	Description
Close()	關閉游標，釋放所有資源，使其完全失效。
CopyStringToBuffer(Int32, CharArrayBuffer)	擷取所請求的欄位文字，並將其儲存在所提供的緩衝區中。
Deactivate()	已淘汰. 停用游標，使所有呼叫失敗，直到 `#requery` 被呼叫為止。
Disposed()	當實例被處理後才被召喚。 (繼承來源 IJavaPeerable)
DisposeUnlessReferenced()	如果沒有未解決的參考資料，則 `Dispose()`呼叫;否則，則不做任何事。 (繼承來源 IJavaPeerable)
Finalized()	當實例完成後才會被通知。 (繼承來源 IJavaPeerable)
GetBlob(Int32)	回傳請求欄位的值，以位元組陣列形式呈現。
GetColumnIndex(String)	回傳給定欄位名稱的零索引，若欄位不存在則回傳 -1。
GetColumnIndexOrThrow(String)	回傳給定欄位名稱的零索引，若欄位不存在則拋 `IllegalArgumentException` 出。
GetColumnName(Int32)	回傳給定以零為基礎的欄位名稱。
GetColumnNames()	回傳一個字串陣列，包含結果集中所有欄位的名稱，依照結果中列出的順序排列。
GetDouble(Int32)	會回傳請求欄位的值為重複值。
GetFloat(Int32)	會以浮點數回傳請求欄位的值。
GetInt(Int32)	回傳請求欄位的值為整數。
GetLong(Int32)	會回傳請求欄位的值為 long。
GetShort(Int32)	回傳請求欄位的值為短路。
GetString(Int32)	會以字串形式回傳請求欄位的值。
GetType(Int32)	回傳給定欄位值的資料型態。
IsNull(Int32)	若欄位中的值為空，則回傳 `true` 。
Move(Int32)	將游標相對向前或向後移動，從當前位置移動。
MoveToFirst()	將游標移到第一列。
MoveToLast()	將游標移到最後一排。
MoveToNext()	將游標移到下一列。
MoveToPosition(Int32)	將游標移到絕對位置。
MoveToPrevious()	將游標移到前一列。
RegisterContentObserver(ContentObserver)	註冊一個觀察者，當該游標背後的內容發生變化時會被呼叫。
RegisterDataSetObserver(DataSetObserver)	註冊一個觀察者，當游標資料集內容發生變化時被呼叫，例如資料集透過 `#requery()`、 `#deactivate()`或 `#close()`變更時。
Requery()	已淘汰. 再次執行產生游標的查詢，刷新其內容。
Respond(Bundle)	這是一種帶外方式，讓游標使用者與游標溝通。
SetJniIdentityHashCode(Int32)	將回傳的值設為 `JniIdentityHashCode`。 (繼承來源 IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	此介面提供對資料庫查詢回傳結果集的隨機讀寫存取。 (繼承來源 IJavaPeerable)
SetNotificationUri(ContentResolver, Uri)	註冊以觀看內容 URI 以獲取變更。
SetPeerReference(JniObjectReference)	將回傳的值設為 `PeerReference`。 (繼承來源 IJavaPeerable)
UnregisterContentObserver(ContentObserver)	取消註冊先前透過該游標註冊的觀察者。`#registerContentObserver`
UnregisterDataSetObserver(DataSetObserver)	取消註冊先前透過該游標註冊的觀察者。`#registerContentObserver`
UnregisterFromRuntime()	取消註冊此實例，讓執行時不會在未來 Java.Interop.JniRuntime+JniValueManager.PeekValue 的呼叫中回傳該實例。 (繼承來源 IJavaPeerable)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	此介面提供對資料庫查詢回傳結果集的隨機讀寫存取。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於