ISQLData 介面
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
用於將 SQL 使用者定義型別（UDT）自訂映射到 Java 程式語言類別的介面。
[Android.Runtime.Register("java/sql/SQLData", "", "Java.Sql.ISQLDataInvoker")]
public interface ISQLData : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable[<Android.Runtime.Register("java/sql/SQLData", "", "Java.Sql.ISQLDataInvoker")>]
type ISQLData = interface
interface IJavaObject
interface IDisposable
interface IJavaPeerable- 屬性
- 實作
備註
用於將 SQL 使用者定義型別（UDT）自訂映射到 Java 程式語言類別的介面。 實作介面 SQLData 的類別物件會輸入到相應 Connection 物件的類型映射中，並附上該 UDT 的 SQL 名稱，該 UDT 的自訂映射。
通常，實 SQLData 作會為 SQL 結構化型別的每個屬性定義一個欄位，或為某 SQL DISTINCT 型別定義單一欄位。 當使用 UDT ResultSet.getObject 從資料來源取得時，會被映射為該類別的實例。 程式設計師可以像操作 Java 程式語言中的任何其他物件一樣，對此類別實例進行操作，然後透過呼叫PreparedStatement.setObject該方法儲存對其所做的變更，該方法會將其映射回 SQL 型別。
預期自訂映射類別的實作會由工具完成。 在典型的實作中，程式設計師只需提供 SQL UDT 的名稱、其被映射的類別名稱，以及每個 UDT 屬性要映射到的欄位名稱。 工具將利用這些資訊來實作 SQLData.readSQL and SQLData.writeSQL 方法。 該方法呼叫 readSQL 適當的 SQLInput 方法從物件讀取每個屬性 SQLInput ，並 writeSQL 呼叫 SQLOutput 方法將每個屬性透過物件寫回資料來源 SQLOutput 。
應用程式設計師通常不會直接呼叫 SQLData 方法， SQLInput 且 和 SQLOutput 方法是由方法內部呼叫 SQLData ，而非應用程式程式碼。
在 1.2 版本中加入。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
屬性
| 名稱 | Description |
|---|---|
| Handle |
取得底層 Android 物件的 JNI 值。 (繼承來源 IJavaObject) |
| JniIdentityHashCode |
回傳包裹實例的 |
| JniManagedPeerState |
管理貴族的狀況。 (繼承來源 IJavaPeerable) |
| JniObjectReferenceControlBlock |
用於將 SQL 使用者定義型別（UDT）自訂映射到 Java 程式語言類別的介面。 (繼承來源 IJavaPeerable) |
| JniPeerMembers |
成員存取與召喚支援。 (繼承來源 IJavaPeerable) |
| PeerReference |
回傳JniObjectReference包裹後的 Java 物件實例。 (繼承來源 IJavaPeerable) |
| SQLTypeName |
取得該物件所代表 的使用者定義型別 （UDT）的 SQL 名稱。 |
方法
| 名稱 | Description |
|---|---|
| Disposed() |
當實例被處理後才被召喚。 (繼承來源 IJavaPeerable) |
| DisposeUnlessReferenced() |
如果沒有未解決的參考資料，則 |
| Finalized() |
當實例完成後才會被通知。 (繼承來源 IJavaPeerable) |
| ReadSQL(ISQLInput, String) |
用從資料庫讀取的資料填充這個物件。 |
| SetJniIdentityHashCode(Int32) |
將回傳的值設為 |
| SetJniManagedPeerState(JniManagedPeerStates) |
用於將 SQL 使用者定義型別（UDT）自訂映射到 Java 程式語言類別的介面。 (繼承來源 IJavaPeerable) |
| SetPeerReference(JniObjectReference) |
將回傳的值設為 |
| UnregisterFromRuntime() |
取消註冊此實例，讓執行時不會在未來 Java.Interop.JniRuntime+JniValueManager.PeekValue 的呼叫中回傳該實例。 (繼承來源 IJavaPeerable) |
| WriteSQL(ISQLOutput) |
將此物件寫入給定的 SQL 資料串流，並將其轉換回資料來源中的 SQL 值。 |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
用於將 SQL 使用者定義型別（UDT）自訂映射到 Java 程式語言類別的介面。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |