IConnection 介面

定義

命名空間:

Java.Sql

組件:

Mono.Android.dll

具有特定資料庫的連線（會話）。

[Android.Runtime.Register("java/sql/Connection", "", "Java.Sql.IConnectionInvoker")]
public interface IConnection : IDisposable, Java.Interop.IJavaPeerable, Java.Sql.IWrapper

[<Android.Runtime.Register("java/sql/Connection", "", "Java.Sql.IConnectionInvoker")>]
type IConnection = interface
    interface IWrapper
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable IWrapper IDisposable

備註

具有特定資料庫的連線（會話）。 執行 SQL 語句，並在連接的內容中傳回結果。

Connection對象的資料庫可以提供描述其數據表、其支援的 SQL 文法、其預存程式、此連接的功能等等的資訊。 這項資訊是使用 getMetaData 方法取得的。

<B>注意：</B> 設定 時 Connection，JDBC 應用程式應該使用 適當的 Connection 方法，例如 setAutoCommit 或 setTransactionIsolation。 當有 JDBC 方法可用時，應用程式不應該直接叫用 SQL 命令來變更連線的組態。 根據預設， Connection 對象處於自動認可模式，這表示它會在執行每個語句之後自動認可變更。 如果已停用自動認可模式，則必須明確呼叫 方法 commit 才能認可變更，否則不會儲存資料庫變更。

使用 JDBC 2.1 核心 API 所建立的新 Connection 物件，一開始有與其相關聯的空白類型對應。 用戶可以在此類型對應中輸入UDT的自定義對應。 使用 方法 ResultSet.getObject從數據源擷取 UDT 時， getObject 此方法會檢查連線的類型對應，以查看該 UDT 是否有專案。 如果是，方法 getObject 會將 UDT 對應至指定的類別。 如果沒有專案，則會使用標準對應來對應UDT。

使用者可以建立新的類型對應，也就是 java.util.Map 物件、在其中建立專案，並將它 java.sql 傳遞給可執行自定義對應的方法。 在此情況下，方法會使用指定的類型對應，而不是與連接相關聯的對應。

例如，下列代碼段會指定 SQL 類型 ATHLETES 將對應至 Java 程式設計語言中的 類別 Athletes 。 代碼段會擷 Connection 取物件的 con型別對應、將專案插入其中，然後將新專案設定為連接類型對應的類型對應。

java.util.Map map = con.getTypeMap();
                 map.put("mySchemaName.ATHLETES", Class.forName("Athletes"));
                 con.setTypeMap(map);

的 java.sql.ConnectionJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

欄位

TransactionNone	常數，表示不支援交易。
TransactionReadCommitted	常數，表示已防止讀取的骯髒;可能會發生不可重複的讀取和虛設讀取。
TransactionReadUncommitted	常數，表示可能發生臟讀取、不可重複讀取和虛設讀取。
TransactionRepeatableRead	常數，指出會防止骯髒的讀取和不可重複的讀取;可能發生虛設的讀取。
TransactionSerializable	常數，表示會防止臟讀取、不可重複的讀取和虛設讀取。

屬性

AutoCommit	傳回 ， boolean 指出這個連接是否處於 auto-commit 作業模式。
Catalog	取得這個 Connection 物件的目前目錄名稱。
ClientInfo	傳 Properties 回物件，其中包含所有用戶端資訊屬性。
Handle	取得基礎 Android 物件的 JNI 值。 (繼承來源 IJavaObject)
Holdability	傳回這個實例所產生的任何 ResultSet 保留性屬性。
IsClosed	傳回 ， boolean 指出這個連接是否處於 closed 狀態。
JniIdentityHashCode	傳回包裝實例的 值 java.lang.System.identityHashCode() 。 (繼承來源 IJavaPeerable)
JniManagedPeerState	受控對等的狀態。 (繼承來源 IJavaPeerable)
JniPeerMembers	成員存取和調用支援。 (繼承來源 IJavaPeerable)
MetaData	取得這個連接所參考之資料庫的相關元數據。
PeerReference	傳 JniObjectReference 回已包裝 Java 物件實例的 。 (繼承來源 IJavaPeerable)
ReadOnly	boolean傳回 ，指出這個連接目前是否處於read-only狀態。
TransactionIsolation	傳回此連線的交易隔離等級。
TypeMap	傳回與此對象相關聯的型別 Connection 對應。
Warnings	取得使用這個連接時可能已建立之任何 SQLWarning 物件的第一個實例。

方法

ClearWarnings()	清除針對這個 Connection 物件報告的所有警告。
Close()	立即釋放此 Connection 物件的資料庫和 JDBC 資源，而不是等待它們自動釋放。
Commit()	進行先前認可/復原之後所做的所有變更，並釋放此 Connection 物件目前持有的任何資料庫鎖定。
CreateArrayOf(String, Object[])	用於建立Array物件的 Factory 方法。
CreateBlob()	建構實作 介面的物件 Blob 。
CreateClob()	建構實作 介面的物件 Clob 。
CreateNClob()	建構實作 介面的物件 NClob 。
CreateSQLXML()	建構實作 介面的物件 SQLXML 。
CreateStatement()	Statement建立物件，以便將 SQL 語句傳送至資料庫。
CreateStatement(Int32, Int32)	Statement建立物件，以產生ResultSet具有指定型別和並行的物件。
CreateStatement(Int32, Int32, Int32)	Statement建立物件，以產生ResultSet具有指定型別、並行和保留性的物件。
CreateStruct(String, Object[])	用於建立結構物件的 Factory 方法。
Disposed()	處置實例時呼叫。 (繼承來源 IJavaPeerable)
DisposeUnlessReferenced()	如果這個實例沒有未完成的參考，則呼叫 Dispose()，否則不會執行任何動作。 (繼承來源 IJavaPeerable)
Finalized()	實例完成時呼叫。 (繼承來源 IJavaPeerable)
GetClientInfo(String)	傳回名稱所指定之用戶端資訊屬性的值。
IsValid(Int32)	如果連接尚未關閉且仍然有效，則傳回 true。
IsWrapperFor(Class)	如果這個 會實作介面自變數，或直接或間接為執行之對象的包裝函式，則傳回 true。 (繼承來源 IWrapper)
NativeSQL(String)	將指定的 SQL 語句轉換成系統的原生 SQL 文法。
PrepareCall(String)	CallableStatement建立物件來呼叫資料庫預存程式。
PrepareCall(String, Int32, Int32)	CallableStatement建立物件，以產生ResultSet具有指定型別和並行的物件。
PrepareCall(String, Int32, Int32, Int32)	CallableStatement建立物件，以產生ResultSet具有指定型別和並行的物件。
PrepareStatement(String)	PreparedStatement建立物件，以便將參數化 SQL 語句傳送至資料庫。
PrepareStatement(String, Int32)	建立默認 PreparedStatement 物件，其能夠擷取自動產生的索引鍵。
PrepareStatement(String, Int32, Int32)	PreparedStatement建立物件，以產生ResultSet具有指定型別和並行的物件。
PrepareStatement(String, Int32, Int32, Int32)	PreparedStatement建立物件，以產生ResultSet具有指定型別、並行和保留性的物件。
PrepareStatement(String, Int32[])	建立能夠傳回指定陣列所指定之自動產生索引鍵的預設 PreparedStatement 物件。
PrepareStatement(String, String[])	建立能夠傳回指定陣列所指定之自動產生索引鍵的預設 PreparedStatement 物件。
ReleaseSavepoint(ISavepoint)	從目前的交易中移除指定的 Savepoint 和後續 Savepoint 物件。
Rollback()	復原目前交易中所做的所有變更，並釋放此 Connection 物件目前持有的任何資料庫鎖定。
Rollback(ISavepoint)	復原在設定指定 Savepoint 對象之後所做的所有變更。
SetClientInfo(String, String)	將名稱所指定的用戶端資訊屬性值設定為 value 所指定的值。
SetJniIdentityHashCode(Int32)	設定所 JniIdentityHashCode傳回的值。 (繼承來源 IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	具有特定資料庫的連線（會話）。 (繼承來源 IJavaPeerable)
SetPeerReference(JniObjectReference)	設定所 PeerReference傳回的值。 (繼承來源 IJavaPeerable)
SetSavepoint()	在目前交易中建立未命名的儲存點，並傳回代表它的新 Savepoint 物件。
SetSavepoint(String)	在目前交易中建立具有指定名稱的儲存點，並傳回代表它的新 Savepoint 物件。
UnregisterFromRuntime()	取消註冊此實例，讓運行時間不會從未來的 Java.Interop.JniRuntime+JniValueManager.PeekValue 調用傳回它。 (繼承來源 IJavaPeerable)
Unwrap(Class)	傳回 物件，這個物件會實作指定的介面，以允許存取非標準方法，或 Proxy 未公開的標準方法。 (繼承來源 IWrapper)

擴充方法

JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	具有特定資料庫的連線（會話）。
GetJniTypeName(IJavaPeerable)	具有特定資料庫的連線（會話）。