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 。 代码片段检索对象的con类型映射Connection ，将条目插入其中，然后将新条目设置为连接类型映射。

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 对象的工厂方法。
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[])	用于创建结构对象的工厂方法。
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)	将名称指定的客户端信息属性的值设置为值指定的值。
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)

扩展方法

JavaCast<TResult>(IJavaObject)	执行 Android 运行时检查的类型转换。
JavaCast<TResult>(IJavaObject)	具有特定数据库的连接（会话）。
GetJniTypeName(IJavaPeerable)	具有特定数据库的连接（会话）。