IConnection 介面

定義

命名空間:: Java.Sql

組件:: Mono.Android.dll

重要

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

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

[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> 在配置， ConnectionJDBC 應用程式應使用適當的 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。程式碼片段會取得物件con的Connection 型別映射，插入該條目，然後將新條目設定為連線的型別映射。

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

Java 文件 java.sql.Connection。

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

欄位

名稱	Description
TransactionNone	一個常數表示不支援交易。
TransactionReadCommitted	一個常數表示防止髒讀;不可重複讀取和幻影讀取可能會發生。
TransactionReadUncommitted	一個常數表示髒讀、不可重複讀及幻影讀。
TransactionRepeatableRead	一個常數表示防止髒讀和不可重複讀取;幻影讀取可能會發生。
TransactionSerializable	一個常數表示避免髒讀、不可重複讀及幻影讀。

屬性

名稱	Description
AutoCommit	回傳 a `boolean` 表示此連線是否處於 `auto-commit` 運作模式。
Catalog	取得該 `Connection` 物件目前的目錄名稱。
ClientInfo	回傳 Properties 一個包含所有客戶端資訊屬性的物件。
Handle	取得底層 Android 物件的 JNI 值。 (繼承來源 IJavaObject)
Holdability	返回由此實例產生的任何 `ResultSet` 物體所擁有的可持有性性質。
IsClosed	回傳 a `boolean` 表示該連線是否在該 `closed` 狀態。
JniIdentityHashCode	回傳包裹實例的 `java.lang.System.identityHashCode()` 值。 (繼承來源 IJavaPeerable)
JniManagedPeerState	管理貴族的狀況。 (繼承來源 IJavaPeerable)
JniObjectReferenceControlBlock	與特定資料庫的連線（會話）。 (繼承來源 IJavaPeerable)
JniPeerMembers	成員存取與召喚支援。 (繼承來源 IJavaPeerable)
MetaData	取得這個連線所參考的資料庫元資料。
PeerReference	回傳JniObjectReference包裹後的 Java 物件實例。 (繼承來源 IJavaPeerable)
ReadOnly	回傳 a `boolean` 表示該連線目前是否仍在該 `read-only` 狀態。
TransactionIsolation	回傳此連線的交易隔離層級。
TypeMap	回傳與此 `Connection` 物件相關的類型映射。
Warnings	取得可能在此連線中使用中所產生的任何 `SQLWarning` 物件的第一個實例。

方法

名稱	Description
ClearWarnings()	清除所有關於此 `Connection` 物體的警告。
Close()	立即釋放此 `Connection` 物件的資料庫與 JDBC 資源，而非等待自動釋放。
Commit()	將自上次提交/回滾以來的所有變更永久化，並釋放此 `Connection` 物件目前持有的任何資料庫鎖。
CreateArrayOf(String, Object[])	工廠方法用於建立陣列物件。
CreateBlob()	建構一個實作介面的 `Blob` 物件。
CreateClob()	建構一個實作介面的 `Clob` 物件。
CreateNClob()	建構一個實作介面的 `NClob` 物件。
CreateSQLXML()	建構一個實作介面的 `SQLXML` 物件。
CreateStatement()	建立 `Statement` 一個物件，用來將 SQL 陳述式傳送到資料庫。
CreateStatement(Int32, Int32, Int32)	建立 `Statement` 一個物件，能產生 `ResultSet` 具有特定類型、並行性及可hold性的物件。
CreateStatement(Int32, Int32)	建立 `Statement` 一個物件，能產生 `ResultSet` 具有指定類型與並行性的物件。
CreateStruct(String, Object[])	工廠方法用於建立結構體物件。
Disposed()	當實例被處理後才被召喚。 (繼承來源 IJavaPeerable)
DisposeUnlessReferenced()	如果沒有未解決的參考資料，則 `Dispose()`呼叫;否則，則不做任何事。 (繼承來源 IJavaPeerable)
Finalized()	當實例完成後才會被通知。 (繼承來源 IJavaPeerable)
GetClientInfo(String)	回傳以名稱指定的客戶資訊屬性值。
IsValid(Int32)	如果連線尚未關閉且仍然有效，則會回傳為真。
IsWrapperFor(Class)	如果這要麼實作了介面參數，要麼直接或間接地為一個包含介面參數的物件包裝，則回傳為真。 (繼承來源 IWrapper)
NativeSQL(String)	將給定的 SQL 語句轉換成系統的原生 SQL 文法。
PrepareCall(String, Int32, Int32, Int32)	建立 `CallableStatement` 一個物件，能產生 `ResultSet` 具有指定類型與並行性的物件。
PrepareCall(String, Int32, Int32)	建立 `CallableStatement` 一個物件，能產生 `ResultSet` 具有指定類型與並行性的物件。
PrepareCall(String)	建立 `CallableStatement` 一個物件來呼叫資料庫儲存程序。
PrepareStatement(String, Int32, Int32, Int32)	建立 `PreparedStatement` 一個物件，能產生 `ResultSet` 具有特定類型、並行性及可hold性的物件。
PrepareStatement(String, Int32, Int32)	建立 `PreparedStatement` 一個物件，能產生 `ResultSet` 具有指定類型與並行性的物件。
PrepareStatement(String, Int32)	建立 `PreparedStatement` 一個預設物件，具備擷取自動產生鍵的能力。
PrepareStatement(String, Int32[])	建立 `PreparedStatement` 一個預設物件，能夠回傳由指定陣列指定的自動產生鍵。
PrepareStatement(String, String[])	建立 `PreparedStatement` 一個預設物件，能夠回傳由指定陣列指定的自動產生鍵。
PrepareStatement(String)	建立 `PreparedStatement` 一個物件，用來將參數化的 SQL 語句傳送到資料庫。
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)	回傳一個物件，實作給定介面，允許存取非標準方法，或代理未暴露的標準方法。 (繼承來源 IWrapper)

擴充方法

名稱	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 端是否有效。

適用於