Поделиться через


Formatter Класс

Определение

Внимание!

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)]
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}")]
public abstract class Formatter : System.Runtime.Serialization.IFormatter
[System.CLSCompliant(false)]
[System.Serializable]
public abstract class Formatter : System.Runtime.Serialization.IFormatter
[System.CLSCompliant(false)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Formatter : System.Runtime.Serialization.IFormatter
[<System.CLSCompliant(false)>]
type Formatter = class
    interface 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
[<System.CLSCompliant(false)>]
[<System.Serializable>]
type Formatter = class
    interface IFormatter
[<System.CLSCompliant(false)>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Formatter = class
    interface IFormatter
Public MustInherit Class Formatter
Implements IFormatter
Наследование
Formatter
Атрибуты
Реализации

Комментарии

Formatter — это базовый abstract класс для всех модулей форматирования сериализации среды выполнения и предоставляет некоторые вспомогательные IFormatter методы для реализации интерфейса . Также Formatter управляет очередями объектов для сериализации и создания идентификаторов на основе каждого объекта.

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

При наследовании от Formatterнеобходимо переопределить следующие элементы:

Конструкторы

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)
Устаревшие..

При переопределении в производном классе записывает значение заданного типа в поток, уже подсоединенный к форматеру.

Применяется к

См. также раздел