使用英语阅读

通过

ISerializable 接口

  • 参考

定义

命名空间:
System.Runtime.Serialization
程序集:
System.Runtime.dll
程序集:
System.Runtime.Serialization.Formatters.dll
程序集:
mscorlib.dll
程序集:
netstandard.dll

允许对象通过二进制和 XML 序列化控制其自己的序列化和反序列化。

C# 
public interface ISerializable
C# 
[System.Runtime.InteropServices.ComVisible(true)]
public interface ISerializable
派生
属性
ComVisibleAttribute

注解

任何可能使用二进制或 XML 序列化进行序列化的类都必须使用 SerializableAttribute标记。 如果类需要控制其二进制或 XML 序列化过程，它可以实现 ISerializable 接口。 在 Formatter 序列化时调用 GetObjectData ，并使用表示 对象所需的所有数据填充提供的 SerializationInfo 。 使用 Formatter 图形中 对象的类型创建 SerializationInfo 。 需要为自己发送代理的对象可以使用 FullTypeName 上的 SerializationInfo 和 AssemblyName 方法来更改传输的信息。

对于类继承，可以序列化派生自实现 的基类的 ISerializable类。 在这种情况下，派生类应在其 的 实现中调用 的GetObjectDataGetObjectData基类实现。 否则，基类中的数据将不会序列化。

接口 ISerializable 表示具有签名 constructor (SerializationInfo information, StreamingContext context)的构造函数。 在反序列化时，只有在格式化程序反序列化 中的数据 SerializationInfo 之后，才会调用当前构造函数。 通常，如果 类不是 sealed，则此构造函数应protected为 。

无法保证对象的反序列化顺序。 例如，如果一个类型引用尚未反序列化的类型，则会发生异常。 如果要创建具有此类依赖项的类型，可以通过实现 IDeserializationCallback 接口和 OnDeserialization 方法来解决此问题。

序列化体系结构处理的对象类型与扩展 MarshalByRefObject 的类型相同 Object。 这些类型可以使用 标记， SerializableAttribute 并将 接口实现 ISerializable 为任何其他对象类型。 它们的对象状态将被捕获并保存到流中。

当通过 System.Runtime.Remoting使用这些类型时，远程处理基础结构会提供一个代理项，该代理优先于典型序列化，而是将代理序列化为 MarshalByRefObject。 代理项是知道如何序列化和反序列化特定类型的对象的帮助程序。 在大多数情况下，对用户不可见的代理的类型为 ObjRef。

作为一种常规设计模式，使用可序列化属性和扩展 MarshalByRefObject标记类是不寻常的。 在结合这两个特征时，开发人员应仔细考虑可能的序列化和远程处理方案。 可能适用的一个 MemoryStream示例是 使用 。 虽然 (Stream 的MemoryStream基类) 从 MarshalByRefObject扩展，但可以捕获 状态MemoryStream并随时还原。 因此，将此流的状态序列化为数据库并在以后的某个时间点还原它可能有意义。 但是，通过远程处理使用时，将代理此类型的对象。

有关扩展 MarshalByRefObject的类的序列化的详细信息，请参阅 RemotingSurrogateSelector。 有关实现 ISerializable的详细信息，请参阅 自定义序列化。

备注

此接口不适用于使用 的 System.Text.JsonJSON 序列化。

实施者说明

实现此接口以允许对象参与其自己的序列化和反序列化。

方法

GetObjectData(SerializationInfo, StreamingContext)
已过时.

使用将目标对象序列化所需的数据填充 SerializationInfo。

适用于

产品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

另请参阅