IFormatter Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Внимание
BinaryFormatter serialization is obsolete and should not be used. See https://aka.ms/binaryformatter for more information.
Предоставляет функции форматирования сериализованных объектов.
public interface class IFormatter
[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 interface IFormatter
public interface IFormatter
[System.Runtime.InteropServices.ComVisible(true)]
public interface IFormatter
[<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 IFormatter = interface
type IFormatter = interface
[<System.Runtime.InteropServices.ComVisible(true)>]
type IFormatter = interface
Public Interface IFormatter
- Производный
- Атрибуты
Комментарии
Этот интерфейс должен быть реализован любым классом, определяемым как форматировщик в архитектуре System.Runtime.Serialization .
Объекты, управляющие собственной сериализацией, могут сделать это, реализуя ISerializable интерфейс. Чтобы сериализовать объект, необходимо пометить этот объект как сериализуемый. Это можно сделать, применив сериализуемый атрибут к классу. Если любой объект в графе не является сериализуемым, сериализация завершится ошибкой.
Примечания для тех, кто реализует этот метод
Все модули форматирования должны реализовать этот интерфейс. Используется Serialize(Stream, Object) для сериализации объекта или графа объектов. Используется Deserialize(Stream) для десериализации потока и создания клона исходного объекта или графа объектов.
Свойства
| Имя | Описание |
|---|---|
| Binder |
Устаревшие..
Возвращает или задает запросы SerializationBinder типов во время десериализации. |
| Context |
Устаревшие..
Возвращает или задает используемый StreamingContext для сериализации и десериализации. |
| SurrogateSelector |
Устаревшие..
Возвращает или задает используемый SurrogateSelector текущим форматировщиком. |
Методы
| Имя | Описание |
|---|---|
| Deserialize(Stream) |
Устаревшие..
Десериализирует данные в предоставленном потоке и восстанавливает граф объектов. |
| Serialize(Stream, Object) |
Устаревшие..
Сериализует объект или граф объектов с заданным корнем в предоставленный поток. |