ISQLData 接口
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,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
- 属性
- 实现
注解
用于将 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 中添加。
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。
属性
| 名称 | 说明 |
|---|---|
| Handle |
获取基础 Android 对象的 JNI 值。 (继承自 IJavaObject) |
| JniIdentityHashCode |
返回包装实例的值 |
| JniManagedPeerState |
托管对等方的状态。 (继承自 IJavaPeerable) |
| JniPeerMembers |
成员访问和调用支持。 (继承自 IJavaPeerable) |
| PeerReference |
返回JniObjectReference包装的Java对象实例。 (继承自 IJavaPeerable) |
| SQLTypeName |
获取此对象所表示的用户 定义类型 (UDT) 的 SQL 名称。 |
方法
| 名称 | 说明 |
|---|---|
| Disposed() |
在释放实例时调用。 (继承自 IJavaPeerable) |
| DisposeUnlessReferenced() |
如果没有对此实例的未完成引用,则调用 |
| Finalized() |
在实例完成时调用。 (继承自 IJavaPeerable) |
| ReadSQL(ISQLInput, String) |
使用从数据库读取的数据填充此对象。 |
| SetJniIdentityHashCode(Int32) |
设置由 |
| SetJniManagedPeerState(JniManagedPeerStates) |
用于将 SQL 用户定义类型(UDT)的自定义映射的接口映射到Java编程语言中的类。 (继承自 IJavaPeerable) |
| SetPeerReference(JniObjectReference) |
设置由 |
| UnregisterFromRuntime() |
取消注册此实例,使运行时不会从将来 Java.Interop.JniRuntime+JniValueManager.PeekValue 的调用中返回它。 (继承自 IJavaPeerable) |
| WriteSQL(ISQLOutput) |
将此对象写入给定的 SQL 数据流,将其转换回数据源中的 SQL 值。 |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
用于将 SQL 用户定义类型(UDT)的自定义映射的接口映射到Java编程语言中的类。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |