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

Комментарии

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