IFormatter Interfejs

Odwołanie

Definicja

Przestrzeń nazw:: System.Runtime.Serialization

Zestaw:: System.Runtime.Serialization.Formatters.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Przestroga

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

Udostępnia funkcje formatowania serializowanych obiektów.

public interface class IFormatter

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}")]
public interface IFormatter

[System.Runtime.InteropServices.ComVisible(true)]
public interface IFormatter

type IFormatter = interface

[<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

[<System.Runtime.InteropServices.ComVisible(true)>]
type IFormatter = interface

Public Interface IFormatter

Pochodne: System.Runtime.Remoting.Messaging.IRemotingFormatter

System.Runtime.Serialization.Formatter

System.Runtime.Serialization.Formatters.Binary.BinaryFormatter

System.Runtime.Serialization.Formatters.Soap.SoapFormatter

System.Runtime.Serialization.NetDataContractSerializer

Więcej…

Atrybuty: ObsoleteAttribute ComVisibleAttribute

Uwagi

Ten interfejs musi być zaimplementowany przez dowolną klasę zidentyfikowaną jako formatator w architekturze System.Runtime.Serialization .

Obiekty kontrolujące ich własną serializacji mogą to zrobić, implementując ISerializable interfejs. Aby obiekt był serializowany, należy oznaczyć ten obiekt jako możliwy do serializacji. Można to zrobić, stosując atrybut możliwy do serializacji do klasy. Jeśli jakikolwiek obiekt na grafie nie można serializować, serializacja zakończy się niepowodzeniem.

Uwagi dotyczące implementowania

Wszystkie formatery muszą zaimplementować ten interfejs. Służy Serialize(Stream, Object) do serializacji obiektu lub grafu obiektów. Służy Deserialize(Stream) do deserializacji strumienia i tworzenia klonu oryginalnego obiektu lub grafu obiektów.

Właściwości

Binder	Przestarzałe. Pobiera lub ustawia SerializationBinder wyszukiwanie typów podczas deserializacji.
Context	Przestarzałe. Pobiera lub ustawia StreamingContext wartość używaną do serializacji i deserializacji.
SurrogateSelector	Przestarzałe. Pobiera lub ustawia SurrogateSelector wartość używaną przez bieżący formater.

Metody

Deserialize(Stream)	Przestarzałe. Deserializuje dane na podanym strumieniu i odtwarza graf obiektów.
Serialize(Stream, Object)	Przestarzałe. Serializuje obiekt lub graf obiektów z danym elementem głównym dla podanego strumienia.

Dotyczy