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) |
Устаревшие..
Проверяет тип полученных данных и вызывает соответствующий |
| 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) |
Устаревшие..
При переопределении в производном классе записывает значение заданного типа в поток, уже подключенный к методу форматирования. |