Formatter 类

定义

命名空间:

System.Runtime.Serialization

程序集:

System.Runtime.Serialization.Formatters.dll

Source:

Formatter.cs

注意

BinaryFormatter serialization is obsolete and should not be used. See https://aka.ms/binaryformatter for more information.

重要

此 API 不符合 CLS。

提供公共语言运行时序列化格式化程序的基本功能。

public ref class Formatter abstract : System::Runtime::Serialization::IFormatter

[System.CLSCompliant(false)]
[System.Obsolete("BinaryFormatter serialization is obsolete and should not be used. See https://aka.ms/binaryformatter for more information.", DiagnosticId="SYSLIB0011", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public abstract class Formatter : System.Runtime.Serialization.IFormatter

[<System.CLSCompliant(false)>]
[<System.Obsolete("BinaryFormatter serialization is obsolete and should not be used. See https://aka.ms/binaryformatter for more information.", DiagnosticId="SYSLIB0011", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type Formatter = class
    interface IFormatter

Public MustInherit Class Formatter
Implements IFormatter

继承

Object

Formatter

属性

CLSCompliantAttribute ObsoleteAttribute

实现

IFormatter

注解

Formatterabstract是所有运行时序列化格式化程序的基类，并提供一些用于实现 接口的IFormatter帮助程序方法。 Formatter还管理序列化的队列对象，并基于每个对象生成 ID。

实施者说明

从 Formatter继承时，必须重写以下成员：

• Serialize(Stream, Object)

• Deserialize(Stream)

• WriteArray(Object, String, Type)

• WriteBoolean(Boolean, String)

• WriteByte(Byte, String)

• WriteChar(Char, String)

• WriteDateTime(DateTime, String)

• WriteDecimal(Decimal, String)

• WriteDouble(Double, String)

• WriteInt16(Int16, String)

• WriteInt32(Int32, String)

• WriteInt64(Int64, String)

• WriteObjectRef(Object, String, Type)

• WriteSByte(SByte, String)

• WriteSingle(Single, String)

• WriteTimeSpan(TimeSpan, String)

• WriteUInt16(UInt16, String)

• WriteUInt32(UInt32, String)

• WriteUInt64(UInt64, String)

• WriteValueType(Object, String, Type)

• SurrogateSelector

• Binder

• Context

构造函数

Formatter()

已过时. 初始化 Formatter 类的新实例。

字段

m_idGenerator	已过时. 包含与当前格式化程序一起使用的 ObjectIDGenerator。
m_objectQueue	已过时. 包含要序列化的对象的 Queue。

属性

Binder	已过时. 当在派生类中重写时，获取或设置与当前格式化程序一起使用的 SerializationBinder。
Context	已过时. 当在派生类中重写时，获取或设置用于当前序列化的 StreamingContext。
SurrogateSelector	已过时. 当在派生类中重写时，获取或设置与当前格式化程序一起使用的 ISurrogateSelector。

方法

Deserialize(Stream)	当在派生类中重写时，将连接到格式化程序的流反序列化（在创建该流时），以创建与最初序列化为该流的图形相同的对象图形。
Equals(Object)	已过时. 确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	已过时. 作为默认哈希函数。 (继承自 Object)
GetNext(Int64)	已过时. 从格式化程序的内部工作队列返回下一个要序列化的对象。
GetType()	已过时. 获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	已过时. 创建当前 Object 的浅表副本。 (继承自 Object)
Schedule(Object)	已过时. 安排对象在稍后进行序列化。
Serialize(Stream, Object)	当在派生类中重写时，将具有指定根的对象图形序列化为已经连接到格式化程序的流。
ToString()	已过时. 返回表示当前对象的字符串。 (继承自 Object)
WriteArray(Object, String, Type)	已过时. 当在派生类中重写时，向已经连接到格式化程序的流中写入一个数组。
WriteBoolean(Boolean, String)	已过时. 当在派生类中重写时，向已经连接到格式化程序的流中写入一个 Boolean 值。
WriteByte(Byte, String)	已过时. 当在派生类中重写时，向已经连接到格式化程序的流中写入一个 8 位无符号整数。
WriteChar(Char, String)	已过时. 当在派生类中重写时，向已经连接到格式化程序的流中写入一个 Unicode 字符。
WriteDateTime(DateTime, String)	已过时. 当在派生类中重写时，向已经连接到格式化程序的流中写入一个 DateTime 值。
WriteDecimal(Decimal, String)	已过时. 当在派生类中重写时，向已经连接到格式化程序的流中写入一个 Decimal 值。
WriteDouble(Double, String)	已过时. 当在派生类中重写时，向已经连接到格式化程序的流中写入一个双精度浮点数字。
WriteInt16(Int16, String)	已过时. 当在派生类中重写时，向已经连接到格式化程序的流中写入一个 16 位有符号整数。
WriteInt32(Int32, String)	已过时. 当在派生类中重写时，向流中写入一个 32 位有符号整数。
WriteInt64(Int64, String)	已过时. 当在派生类中重写时，向流中写入一个 64 位有符号整数。
WriteMember(String, Object)	已过时. 检查所接收的数据的类型，并调用相应的 Write 方法向已经连接到格式化程序的流中写入对象。
WriteObjectRef(Object, String, Type)	已过时. 当在派生类中重写时，向已经连接到格式化程序的流中写入一个对象引用。
WriteSByte(SByte, String)	已过时. 当在派生类中重写时，向已经连接到格式化程序的流中写入一个 8 位有符号整数。
WriteSingle(Single, String)	已过时. 当在派生类中重写时，向已经连接到格式化程序的流中写入一个单精度浮点数字。
WriteTimeSpan(TimeSpan, String)	已过时. 当在派生类中重写时，向已经连接到格式化程序的流中写入一个 TimeSpan 值。
WriteUInt16(UInt16, String)	已过时. 当在派生类中重写时，向已经连接到格式化程序的流中写入一个 16 位无符号整数。
WriteUInt32(UInt32, String)	已过时. 当在派生类中重写时，向已经连接到格式化程序的流中写入一个 32 位无符号整数。
WriteUInt64(UInt64, String)	已过时. 当在派生类中重写时，向已经连接到格式化程序的流中写入一个 64 位无符号整数。
WriteValueType(Object, String, Type)	已过时. 当在派生类中重写时，向已经连接到格式化程序的流中写入给定类型的值。

另请参阅

• ObjectIDGenerator
• XML 和 SOAP 序列化