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.Connection JAVA 檔。

此頁面的部分是根據 原始碼專案所建立和共用的工作進行修改，並根據中所述的詞彙使用。

欄位

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)	與特定資料庫的連線 (會話) 。