IDataSource 介面
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
一個用於連接此 DataSource 物件所代表實體資料來源的工廠。
[Android.Runtime.Register("javax/sql/DataSource", "", "Javax.Sql.IDataSourceInvoker")]
public interface IDataSource : IDisposable, Java.Interop.IJavaPeerable, Java.Sql.IWrapper, Javax.Sql.ICommonDataSource
[<Android.Runtime.Register("javax/sql/DataSource", "", "Javax.Sql.IDataSourceInvoker")>]
type IDataSource = interface
interface IWrapper
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface ICommonDataSource
- 屬性
- 實作
備註
一個用於連接此 DataSource 物件所代表實體資料來源的工廠。 作為設施的替代方案 DriverManager ,物件 DataSource 是取得連線的首選方式。 實作此DataSource介面的物件通常會根據 Javasup<>< 字型大小=-2>TM/<font></sup> 命名與目錄(JNDI)API 註冊命名服務。
介面 DataSource 由驅動程式廠商實作。 實作有三種類型: <OL><LI>Basic 實作——產生標準 Connection 物件 <LI>連線池化實作——產生 Connection 一個物件,會自動參與連線池。 此實作可搭配中階連線池管理器運作。
<LI>分散式交易實作——產生 Connection 可用於分散式交易且幾乎總是參與連線池的物件。 此實作可搭配中階交易管理器,且幾乎總是與連線池管理器合作。
</OL>
物件 DataSource 具有可在必要時修改的屬性。 例如,如果資料來源被移至其他伺服器,該伺服器的屬性可以被更改。 優點是因為資料來源的屬性可以被更改,任何存取該資料來源的程式碼都不需要更改。
透過DataSource物件存取的驅動程式不會向 註冊。DriverManager 相反地,物件 DataSource 會透過查找操作取得,然後用來建立物件 Connection 。 在基本實作中,透過 DataSource 物件獲得的連線與透過 DriverManager 設施取得的連接相同。
在 1.4 版本加入。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
屬性
| 名稱 | Description |
|---|---|
| Connection |
建立一個與資料庫的連結,該資料庫由 |
| Handle |
取得底層 Android 物件的 JNI 值。 (繼承來源 IJavaObject) |
| JniIdentityHashCode |
回傳包裹實例的 |
| JniManagedPeerState |
管理貴族的狀況。 (繼承來源 IJavaPeerable) |
| JniObjectReferenceControlBlock |
一個用於連接此 |
| JniPeerMembers |
成員存取與召喚支援。 (繼承來源 IJavaPeerable) |
| LoginTimeout |
嘗試連接資料庫時,此方法能獲得該資料來源可等待的最大時間(秒數)。 (繼承來源 ICommonDataSource) |
| LogWriter |
擷取日誌寫入器,這是一串字元輸出流,所有該資料來源的日誌與追蹤訊息都會被列印到該資料來源。 (繼承來源 ICommonDataSource) |
| ParentLogger |
取得該資料來源所有記錄器的父記錄器。 (繼承來源 ICommonDataSource) |
| PeerReference |
回傳JniObjectReference包裹後的 Java 物件實例。 (繼承來源 IJavaPeerable) |
方法
| 名稱 | Description |
|---|---|
| Disposed() |
當實例被處理後才被召喚。 (繼承來源 IJavaPeerable) |
| DisposeUnlessReferenced() |
如果沒有未解決的參考資料,則 |
| Finalized() |
當實例完成後才會被通知。 (繼承來源 IJavaPeerable) |
| GetConnection(String, String) |
嘗試與該 |
| IsWrapperFor(Class) |
如果這要麼實作了介面參數,要麼直接或間接地為一個包含介面參數的物件包裝,則回傳為真。 (繼承來源 IWrapper) |
| SetJniIdentityHashCode(Int32) |
將回傳的值設為 |
| SetJniManagedPeerState(JniManagedPeerStates) |
一個用於連接此 |
| SetPeerReference(JniObjectReference) |
將回傳的值設為 |
| UnregisterFromRuntime() |
取消註冊此實例,讓執行時不會在未來 Java.Interop.JniRuntime+JniValueManager.PeekValue 的呼叫中回傳該實例。 (繼承來源 IJavaPeerable) |
| Unwrap(Class) |
回傳一個物件,實作給定介面,允許存取非標準方法,或代理未暴露的標準方法。 (繼承來源 IWrapper) |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時間檢查的類型轉換。 |
| JavaCast<TResult>(IJavaObject) |
一個用於連接此 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |