Formatter 类

定义

命名空间:

System.Runtime.Serialization

程序集:

System.Runtime.Serialization.Formatters.dll

Source:

Formatter.cs

重要

此 API 不符合 CLS。

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

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

[System.CLSCompliant(false)]
public abstract class Formatter : System.Runtime.Serialization.IFormatter

[<System.CLSCompliant(false)>]
type Formatter = class
    interface IFormatter

Public MustInherit Class Formatter
Implements IFormatter

继承

Object

Formatter

属性

CLSCompliantAttribute

实现

IFormatter

注解

Formatter abstract是所有运行时序列化格式化程序的基类，并提供一些用于实现 接口的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 序列化