ISQLData 接口

定义

命名空间:: Java.Sql

程序集:: Mono.Android.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

用于将 SQL 用户定义类型（UDT）的自定义映射的接口映射到Java编程语言中的类。

[Android.Runtime.Register("java/sql/SQLData", "", "Java.Sql.ISQLDataInvoker")]
public interface ISQLData : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("java/sql/SQLData", "", "Java.Sql.ISQLDataInvoker")>]
type ISQLData = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

属性: RegisterAttribute

实现: IJavaObject IJavaPeerable IDisposable

注解

用于将 SQL 用户定义类型（UDT）的自定义映射的接口映射到Java编程语言中的类。实现 SQLData 接口的类的类对象将在相应 Connection 对象的类型映射中输入，以及它是自定义映射的 UDT 的 SQL 名称。

通常， SQLData 实现将为 SQL 结构化类型的每个属性或 SQL DISTINCT 类型的单个字段定义字段。使用 ResultSet.getObject 该方法从数据源检索 UDT 时，它将映射为此类的实例。程序员可以像Java编程语言中的任何其他对象一样对此类实例进行操作，然后通过调用PreparedStatement.setObject该方法来存储对它所做的任何更改，该方法会将它映射回 SQL 类型。

预计自定义映射的类实现将由工具完成。在典型的实现中，程序员只需提供 SQL UDT 的名称、要映射到的类的名称，以及要映射到 UDT 的每个属性的字段的名称。该工具将使用此信息来实现 SQLData.readSQL 和 SQLData.writeSQL 方法。该方法 readSQL 调用适当的 SQLInput 方法从对象 SQLInput 中读取每个属性，方法 writeSQL 调用 SQLOutput 方法通过对象将每个属性写回数据源 SQLOutput 。

应用程序程序员通常不会直接调用SQLData方法，并且SQLInput由方法（而不是应用程序代码）在内部SQLData调用和SQLOutput方法。

已在 1.2 中添加。

Java文档java.sql.SQLData。

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

属性

名称	说明
Handle	获取基础 Android 对象的 JNI 值。 (继承自 IJavaObject)
JniIdentityHashCode	返回包装实例的值 `java.lang.System.identityHashCode()` 。 (继承自 IJavaPeerable)
JniManagedPeerState	托管对等方的状态。 (继承自 IJavaPeerable)
JniObjectReferenceControlBlock	用于将 SQL 用户定义类型（UDT）的自定义映射的接口映射到Java编程语言中的类。 (继承自 IJavaPeerable)
JniPeerMembers	成员访问和调用支持。 (继承自 IJavaPeerable)
PeerReference	返回JniObjectReference包装的Java对象实例。 (继承自 IJavaPeerable)
SQLTypeName	获取此对象所表示的用户定义类型（UDT）的 SQL 名称。

方法

名称	说明
Disposed()	在释放实例时调用。 (继承自 IJavaPeerable)
DisposeUnlessReferenced()	如果没有对此实例的未完成引用，则调用 `Dispose()`;否则不执行任何操作。 (继承自 IJavaPeerable)
Finalized()	在实例完成时调用。 (继承自 IJavaPeerable)
ReadSQL(ISQLInput, String)	使用从数据库读取的数据填充此对象。
SetJniIdentityHashCode(Int32)	设置由 `JniIdentityHashCode`. 返回的值。 (继承自 IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	用于将 SQL 用户定义类型（UDT）的自定义映射的接口映射到Java编程语言中的类。 (继承自 IJavaPeerable)
SetPeerReference(JniObjectReference)	设置由 `PeerReference`. 返回的值。 (继承自 IJavaPeerable)
UnregisterFromRuntime()	取消注册此实例，使运行时不会从将来 Java.Interop.JniRuntime+JniValueManager.PeekValue 的调用中返回它。 (继承自 IJavaPeerable)
WriteSQL(ISQLOutput)	将此对象写入给定的 SQL 数据流，将其转换回数据源中的 SQL 值。

扩展方法

名称	说明
GetJniTypeName(IJavaPeerable)	获取实例 `self`类型的 JNI 名称。
JavaAs<TResult>(IJavaPeerable)	尝试强制`self`键入`TResult`，检查强制是否在Java端有效。
JavaCast<TResult>(IJavaObject)	执行 Android 运行时检查的类型转换。
JavaCast<TResult>(IJavaObject)	用于将 SQL 用户定义类型（UDT）的自定义映射的接口映射到Java编程语言中的类。
TryJavaCast<TResult>(IJavaPeerable, TResult)	尝试强制`self`键入`TResult`，检查强制是否在Java端有效。

适用于