Formatter Класс

Определение

Внимание

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

Внимание

Этот API несовместим с CLS.

Предоставляет базовые функции для сериализации сериализации среды cl language.

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

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

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

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