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 文档。

此页面的部分内容是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的术语使用。

字段

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)	返回由 name 指定的客户端信息属性的值。
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)	将 name 指定的客户端信息属性的值设置为值指定的值。
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)	连接 (与特定数据库的会话) 。