IExternalizable 接口
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
只有 Externalizable 实例的类的标识在序列化流中写入,并且类负责保存和还原其实例的内容。
[Android.Runtime.Register("java/io/Externalizable", "", "Java.IO.IExternalizableInvoker")]
public interface IExternalizable : IDisposable, Java.Interop.IJavaPeerable, Java.IO.ISerializable
[<Android.Runtime.Register("java/io/Externalizable", "", "Java.IO.IExternalizableInvoker")>]
type IExternalizable = interface
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 属性
- 实现
注解
只有 Externalizable 实例的类的标识在序列化流中写入,并且类负责保存和还原其实例的内容。
Externalizable 接口的 writeExternal 和 readExternal 方法由类实现,使类能够完全控制对象及其超类型流的格式和内容。 这些方法必须与超类型显式协调才能保存其状态。 这些方法取代 writeObject 和 readObject 方法的自定义实现。<br>
对象序列化使用 Serializable 和 Externalizable 接口。 对象持久性机制也可以使用它们。 要存储的每个对象都针对 Externalizable 接口进行测试。 如果对象支持 Externalizable,将调用 writeExternal 方法。 如果对象不支持 Externalizable 并实现 Serializable,则使用 ObjectOutputStream 保存对象。 <br> 重新构造 Externalizable 对象时,将使用公共 no-arg 构造函数创建实例,然后调用 readExternal 方法。 通过从 ObjectInputStream 读取可序列化对象来还原这些对象。<br>
Externalizable 实例可以通过 Serializable 接口中记录的 writeReplace 和 readResolve 方法指定替换对象。<br>
在 1.1 中添加。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
属性
| 名称 | 说明 |
|---|---|
| Handle |
获取基础 Android 对象的 JNI 值。 (继承自 IJavaObject) |
| JniIdentityHashCode |
返回包装实例的值 |
| JniManagedPeerState |
托管对等方的状态。 (继承自 IJavaPeerable) |
| JniObjectReferenceControlBlock |
只有 Externalizable 实例的类的标识在序列化流中写入,并且类负责保存和还原其实例的内容。 (继承自 IJavaPeerable) |
| JniPeerMembers |
成员访问和调用支持。 (继承自 IJavaPeerable) |
| PeerReference |
返回JniObjectReference包装的Java对象实例。 (继承自 IJavaPeerable) |
方法
| 名称 | 说明 |
|---|---|
| Disposed() |
在释放实例时调用。 (继承自 IJavaPeerable) |
| DisposeUnlessReferenced() |
如果没有对此实例的未完成引用,则调用 |
| Finalized() |
在实例完成时调用。 (继承自 IJavaPeerable) |
| ReadExternal(IObjectInput) |
该对象实现 readExternal 方法,通过调用基元类型的 DataInput 方法以及对象、字符串和数组的 readObject 来还原其内容。 |
| SetJniIdentityHashCode(Int32) |
设置由 |
| SetJniManagedPeerState(JniManagedPeerStates) |
只有 Externalizable 实例的类的标识在序列化流中写入,并且类负责保存和还原其实例的内容。 (继承自 IJavaPeerable) |
| SetPeerReference(JniObjectReference) |
设置由 |
| UnregisterFromRuntime() |
取消注册此实例,使运行时不会从将来 Java.Interop.JniRuntime+JniValueManager.PeekValue 的调用中返回它。 (继承自 IJavaPeerable) |
| WriteExternal(IObjectOutput) |
该对象实现 writeExternal 方法,通过为其基元值调用 DataOutput 的方法或为对象、字符串和数组调用 ObjectOutput 的 writeObject 方法来保存其内容。 |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
只有 Externalizable 实例的类的标识在序列化流中写入,并且类负责保存和还原其实例的内容。 |
| ReadExternalAsync(IExternalizable, IObjectInput) |
只有 Externalizable 实例的类的标识在序列化流中写入,并且类负责保存和还原其实例的内容。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |
| WriteExternalAsync(IExternalizable, IObjectOutput) |
只有 Externalizable 实例的类的标识在序列化流中写入,并且类负责保存和还原其实例的内容。 |