System.Runtime.Serialization Przestrzeń nazw

Zawiera klasy, które mogą być używane do serializacji i deserializacji obiektów. Contains classes that can be used for serializing and deserializing objects. Serializacja to proces konwersji obiektu lub grafu obiektów na sekwencję liniową bajtów w celu przechowywania lub przesyłania do innej lokalizacji. Serialization is the process of converting an object or a graph of objects into a linear sequence of bytes for either storage or transmission to another location. Deserializacja jest procesem pobierania przechowywanych informacji i ponownego tworzenia obiektów z tego obiektu. Deserialization is the process of taking in stored information and recreating objects from it.

Klasy

CollectionDataContractAttribute

W przypadku zastosowania do typu kolekcji, włącza specyfikację niestandardową elementów kolekcji.When applied to a collection type, enables custom specification of the collection item elements. Ten atrybut może być stosowany tylko do typów, które są rozpoznawane przez DataContractSerializer prawidłowe, możliwe do serializacji kolekcje.This attribute can be applied only to types that are recognized by the DataContractSerializer as valid, serializable collections.

ContractNamespaceAttribute

Określa przestrzeń nazw CLR i przestrzeń nazw XML kontraktu danych.Specifies the CLR namespace and XML namespace of the data contract.

DataContractAttribute

Określa, że typ definiuje lub implementuje kontrakt danych i jest możliwy do serializacji przez serializator, taki jak DataContractSerializer .Specifies that the type defines or implements a data contract and is serializable by a serializer, such as the DataContractSerializer. Aby można było serializować typ, autorzy muszą definiować kontrakt danych dla ich typu.To make their type serializable, type authors must define a data contract for their type.

DataContractResolver

Zapewnia mechanizm do dynamicznego mapowania typów do i z xsi:type reprezentacji podczas serializacji i deserializacji.Provides a mechanism for dynamically mapping types to and from xsi:type representations during serialization and deserialization.

DataContractSerializer

Serializować i deserializacji wystąpienia typu do strumienia XML lub dokumentu przy użyciu dostarczonego kontraktu danych.Serializes and deserializes an instance of a type into an XML stream or document using a supplied data contract. Klasa ta nie może być dziedziczona.This class cannot be inherited.

DataContractSerializerExtensions

Rozszerza DataContractSerializer klasę, dostarczając metody do ustawiania i pobierania ISerializationSurrogateProvider .Extends the DataContractSerializer class by providing methods for setting and getting an ISerializationSurrogateProvider.

DataContractSerializerSettings

Określa ustawienia serializatora kontraktu danych.Specifies data contract serializer settings.

DataMemberAttribute

W przypadku zastosowania do elementu członkowskiego typu, określa, że element członkowski jest częścią kontraktu danych i jest możliwy do serializacji przez DataContractSerializer .When applied to the member of a type, specifies that the member is part of a data contract and is serializable by the DataContractSerializer.

DateTimeFormat

Określa opcje formatu daty i godziny.Specifies date-time format options.

EnumMemberAttribute

Określa, że pole jest elementem członkowskim wyliczenia i powinno być serializowane.Specifies that the field is an enumeration member and should be serialized.

ExportOptions

Reprezentuje opcje, które można ustawić dla XsdDataContractExporter .Represents the options that can be set for an XsdDataContractExporter.

ExtensionDataObject

Przechowuje dane z kontraktu danych z wersjami, który został rozszerzony przez dodanie nowych członków.Stores data from a versioned data contract that has been extended by adding new members.

Formatter

Oferuje podstawowe funkcje dla programów formatujących serializacji środowiska uruchomieniowego języka wspólnego.Provides base functionality for the common language runtime serialization formatters.

FormatterConverter

Reprezentuje podstawową implementację IFormatterConverter interfejsu, który używa Convert klasy i IConvertible interfejsu.Represents a base implementation of the IFormatterConverter interface that uses the Convert class and the IConvertible interface.

FormatterServices

Zawiera metody statyczne, które ułatwiają implementację Formatter do serializacji.Provides static methods to aid with the implementation of a Formatter for serialization. Klasa ta nie może być dziedziczona.This class cannot be inherited.

IgnoreDataMemberAttribute

W przypadku zastosowania do elementu członkowskiego typu, określa, że element członkowski nie jest częścią kontraktu danych i nie jest serializowany.When applied to the member of a type, specifies that the member is not part of a data contract and is not serialized.

ImportOptions

Reprezentuje opcje, które można ustawić na XsdDataContractImporter .Represents the options that can be set on an XsdDataContractImporter.

InvalidDataContractException

Wyjątek, który jest generowany, gdy DataContractSerializer lub NetDataContractSerializer napotka nieprawidłowy kontrakt danych podczas serializacji i deserializacji.The exception that is thrown when the DataContractSerializer or NetDataContractSerializer encounters an invalid data contract during serialization and deserialization.

KnownTypeAttribute

Określa typy, które powinny być rozpoznawane przez DataContractSerializer podczas serializacji lub deserializacji danego typu.Specifies types that should be recognized by the DataContractSerializer when serializing or deserializing a given type.

NetDataContractSerializer

Serializować i deserializacji wystąpienia typu do strumienia XML lub dokumentu przy użyciu podanych typów .NET Framework.Serializes and deserializes an instance of a type into XML stream or document using the supplied .NET Framework types. Klasa ta nie może być dziedziczona.This class cannot be inherited.

ObjectIDGenerator

Generuje identyfikatory dla obiektów.Generates IDs for objects.

ObjectManager

Śledzi obiekty w miarę ich deserializacji.Keeps track of objects as they are deserialized.

OnDeserializedAttribute

W przypadku zastosowania do metody, określa, że metoda jest wywoływana natychmiast po deserializacji obiektu w grafie obiektów.When applied to a method, specifies that the method is called immediately after deserialization of an object in an object graph. Kolejność deserializacji względem innych obiektów w grafie jest niejednoznaczna.The order of deserialization relative to other objects in the graph is non-deterministic.

OnDeserializingAttribute

W przypadku zastosowania do metody, określa, że metoda jest wywoływana podczas deserializacji obiektu na grafie obiektu.When applied to a method, specifies that the method is called during deserialization of an object in an object graph. Kolejność deserializacji względem innych obiektów w grafie jest niejednoznaczna.The order of deserialization relative to other objects in the graph is non-deterministic.

OnSerializedAttribute

Po zastosowaniu do metody, określa, że metoda jest wywoływana po serializacji obiektu na grafie obiektu.When applied to a method, specifies that the method is called after serialization of an object in an object graph. Kolejność serializacji względem innych obiektów w grafie jest niedeterministyczna.The order of serialization relative to other objects in the graph is non-deterministic.

OnSerializingAttribute

W przypadku zastosowania do metody, określa, że metoda jest serializacja obiektu na grafie obiektu.When applied to a method, specifies that the method is during serialization of an object in an object graph. Kolejność serializacji względem innych obiektów w grafie jest niedeterministyczna.The order of serialization relative to other objects in the graph is non-deterministic.

OptionalFieldAttribute

Określa, że w strumieniu serializacji nie można wywoływać pola, tak aby i nie zgłaszał BinaryFormatter SoapFormatter wyjątku.Specifies that a field can be missing from a serialization stream so that the BinaryFormatter and the SoapFormatter does not throw an exception.

SafeSerializationEventArgs

Udostępnia dane dla zdarzenia SerializeObjectState.Provides data for the SerializeObjectState event.

SerializationBinder

Umożliwia użytkownikom sterowanie ładowaniem klas i przyznaczenie klasy do załadowania.Allows users to control class loading and mandate what class to load.

SerializationException

Wyjątek zgłoszony w przypadku wystąpienia błędu podczas serializacji lub deserializacji.The exception thrown when an error occurs during serialization or deserialization.

SerializationInfo

Przechowuje wszystkie dane, które są konieczne do serializacji lub deserializacji obiektu.Stores all the data needed to serialize or deserialize an object. Klasa ta nie może być dziedziczona.This class cannot be inherited.

SerializationInfoEnumerator

Zapewnia przyjazny dla programu formatującego mechanizm analizowania danych w programie SerializationInfo .Provides a formatter-friendly mechanism for parsing the data in SerializationInfo. Klasa ta nie może być dziedziczona.This class cannot be inherited.

SerializationObjectManager

Zarządza procesami serializacji w czasie wykonywania.Manages serialization processes at run time. Klasa ta nie może być dziedziczona.This class cannot be inherited.

SurrogateSelector

Pomaga programom formatującego w wyborze surogatu serializacji, aby delegować proces serializacji lub deserializacji do.Assists formatters in selection of the serialization surrogate to delegate the serialization or deserialization process to.

XmlObjectSerializer

Udostępnia klasę bazową służącą do serializacji obiektów jako strumienie lub dokumenty XML.Provides the base class used to serialize objects as XML streams or documents. Ta klasa jest abstrakcyjna.This class is abstract.

XmlSerializableServices

Zawiera metody odczytu i zapisu XML.Contains methods for reading and writing XML.

XPathQueryGenerator

Gdy dana klasa reprezentuje kontrakt danych i metadane reprezentujące element członkowski kontraktu, tworzy zapytanie XPath dla elementu członkowskiego.When given a class representing a data contract, and metadata representing a member of the contract, produces an XPath query for the member.

XsdDataContractExporter

Umożliwia przekształcenie zestawu typów .NET, które są używane w kontraktach danych do pliku schematu XML (XSD).Allows the transformation of a set of .NET types that are used in data contracts into an XML schema file (.xsd).

XsdDataContractImporter

Umożliwia transformację zestawu plików schematu XML (XSD) do typów środowiska uruchomieniowego języka wspólnego (CLR).Allows the transformation of a set of XML schema files (.xsd) into common language runtime (CLR) types.

Struktury

SerializationEntry

Przechowuje wartość, Type i nazwę serializowanego obiektu.Holds the value, Type, and name of a serialized object.

StreamingContext

Opisuje źródło i miejsce docelowe danego serializowanego strumienia i udostępnia dodatkowy kontekst zdefiniowany przez wywołującego.Describes the source and destination of a given serialized stream, and provides an additional caller-defined context.

Interfejsy

IDataContractSurrogate

Dostarcza metody, które są konieczne do zamienienia jednego typu na inny przez DataContractSerializer podczas serializacji, deserializacji i eksportowania i importowania dokumentów schematu XML (XSD).Provides the methods needed to substitute one type for another by the DataContractSerializer during serialization, deserialization, and export and import of XML schema documents (XSD).

IDeserializationCallback

Wskazuje, że Klasa ma zostać powiadomiona o ukończeniu deserializacji całego grafu obiektów.Indicates that a class is to be notified when deserialization of the entire object graph has been completed. Należy zauważyć, że ten interfejs nie jest wywoływany podczas deserializacji za pomocą elementu XmlSerializer (System.Xml.Serialization.Xmlserializator).Note that this interface is not called when deserializing with the XmlSerializer (System.Xml.Serialization.XmlSerializer).

IExtensibleDataObject

Udostępnia strukturę danych do przechowywania dodatkowych danych napotkanych przez XmlObjectSerializer podczas deserializacji typu oznaczonego DataContractAttribute atrybutem.Provides a data structure to store extra data encountered by the XmlObjectSerializer during deserialization of a type marked with the DataContractAttribute attribute.

IFormatter

Oferuje funkcje formatowania serializowanych obiektów.Provides functionality for formatting serialized objects.

IFormatterConverter

Zapewnia połączenie między wystąpieniem SerializationInfo i klasą dostarczoną przez program formatujący, która jest najbardziej przydatna do analizowania danych wewnątrz SerializationInfo .Provides the connection between an instance of SerializationInfo and the formatter-provided class best suited to parse the data inside the SerializationInfo.

IObjectReference

Wskazuje, że bieżący implementujący interfejs jest odwołaniem do innego obiektu.Indicates that the current interface implementer is a reference to another object.

ISafeSerializationData

Umożliwia serializację niestandardowych danych wyjątków w kodzie przezroczystym dla zabezpieczeń.Enables serialization of custom exception data in security-transparent code.

ISerializable

Umożliwia obiektowi sterowanie własną serializacji i deserializacji.Allows an object to control its own serialization and deserialization.

ISerializationSurrogate

Implementuje selektor surogatu serializacji, który umożliwia jednemu obiektowi Wykonywanie serializacji i deserializacji innej.Implements a serialization surrogate selector that allows one object to perform serialization and deserialization of another.

ISerializationSurrogateProvider

Dostarcza metody, które są konieczne do skonstruowania surogatu serializacji, który rozszerza DataContractSerializer .Provides the methods needed to construct a serialization surrogate that extends the DataContractSerializer. Surogat serializacji jest używany podczas serializacji i deserializacji w celu zastąpienia jednego typu dla innego.A serialization surrogate is used during serialization and deserialization to substitute one type for another.

ISurrogateSelector

Wskazuje klasę selektora surogatu serializacji.Indicates a serialization surrogate selector class.

Wyliczenia

EmitTypeInformation

Określa, jak często mają być emitowane informacje o typie.Specifies how often to emit type information.

StreamingContextStates

Definiuje zestaw flag, który określa źródłowy lub docelowy kontekst strumienia podczas serializacji.Defines a set of flags that specifies the source or destination context for the stream during serialization.

Uwagi

ISerializableInterfejs umożliwia klasom sterowanie własnymi zachowaniami serializacji.The ISerializable interface provides a way for classes to control their own serialization behavior. Klasy w System.Runtime.Serialization.Formatters przestrzeni nazw sterują rzeczywistym formatowaniem różnych typów danych, które są hermetyzowane w serializowanych obiektach.Classes in the System.Runtime.Serialization.Formatters namespace control the actual formatting of various data types encapsulated in the serialized objects.

Program formatujący, który serializować i deserializacji obiektów do i z określonego formatu, można znaleźć w System.Runtime.Serialization.Formatters przestrzeni nazw.Formatters that serialize and deserialize objects to and from a particular format can be found in the System.Runtime.Serialization.Formatters namespace.