Udostępnij za pośrednictwem

IFormatter Interfejs

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Runtime.Serialization
Zestaw:
System.Runtime.Serialization.Formatters.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll

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

Zobacz też