Formatter Класс

Определение

Пространство имен:

System.Runtime.Serialization

Сборка:

System.Runtime.Serialization.Formatters.dll

Исходный код:

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 управляет очередями объектов для сериализации и создания идентификаторов на основе каждого объекта.

Примечания для тех, кто реализует этот метод

При наследовании от 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)	При переопределении в производном классе записывает логическое значение в поток, уже подсоединенный к форматеру.
WriteByte(Byte, String)	При переопределении в производном классе записывает 8-битовое целое число без знака в поток, уже подсоединенный к форматеру.
WriteChar(Char, String)	При переопределении в производном классе записывает знак Юникода в поток, уже подсоединенный к форматеру.
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