IFormatter Interfejs
Definicja
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.
Udostępnia funkcje formatowania serializowanych obiektów.
public interface class IFormatterpublic interface IFormatter[System.Runtime.InteropServices.ComVisible(true)]
public interface IFormattertype IFormatter = interface[<System.Runtime.InteropServices.ComVisible(true)>]
type IFormatter = interfacePublic Interface IFormatter- Pochodne
- Atrybuty
Uwagi
Ten interfejs musi być zaimplementowany przez dowolną klasę zidentyfikowaną jako element formatujący w architekturze System.Runtime.Serialization .
Obiekty kontrolujące ich własną serializacji mogą to zrobić przez zaimplementowanie interfejsu ISerializable . 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.
Notatki 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
| Nazwa | Opis |
|---|---|
| Binder |
Pobiera lub ustawia SerializationBinder wyszukiwanie typów podczas deserializacji. |
| Context |
Pobiera lub ustawia StreamingContext używane do serializacji i deserializacji. |
| SurrogateSelector |
Pobiera lub ustawia SurrogateSelector wartość używaną przez bieżący formater. |
Metody
| Nazwa | Opis |
|---|---|
| Deserialize(Stream) |
Deserializuje dane w podanym strumieniu i rekonstytuuje wykres obiektów. |
| Serialize(Stream, Object) |
Serializuje obiekt lub graf obiektów z danym elementem głównym dla podanego strumienia. |