System.Xml.Serialization Przestrzeń nazw

Zawiera klasy używane do serializacji obiektów w dokumentach lub strumieniach w formacie XML.

Klasy

Nazwa	Opis
CodeIdentifier	Udostępnia metody statyczne do konwertowania tekstu wejściowego na nazwy jednostek kodu.
CodeIdentifiers	Utrzymuje grupę nazw powiązanych jednostek kodu lub mapowań typów, które są generowane przez element . Infrastruktura serializacji XML platformy NET.
ImportContext	Opisuje kontekst, w którym zestaw schematu jest powiązany z jednostkami kodu platformy .NET.
SchemaImporter	Opisuje importer schematu.
SoapAttributeAttribute	Określa, że XmlSerializer musi serializować składową klasy jako zakodowany atrybut SOAP.
SoapAttributeOverrides	Umożliwia zastąpienie atrybutów zastosowanych do właściwości, pól i klas w przypadku używania XmlSerializer klasy do serializacji lub deserializacji obiektu jako zakodowanego protokołu SOAP.
SoapAttributes	Reprezentuje kolekcję obiektów atrybutów, które kontrolują sposób XmlSerializer serializacji i deserializuje metody SOAP.
SoapElementAttribute	Określa, że publiczna wartość elementu członkowskiego ma być serializowana przez XmlSerializer jako zakodowany element XML protokołu SOAP.
SoapEnumAttribute	Określa, w jaki sposób XmlSerializer serializuje element członkowski wyliczenia.
SoapIgnoreAttribute	Instruuje XmlSerializer, aby nie serializować pola publicznego lub publicznej wartości właściwości odczytu/zapisu.
SoapIncludeAttribute	Umożliwia XmlSerializer rozpoznawanie typu podczas serializacji lub deserializowania obiektu jako zakodowanego kodu XML PROTOKOŁU SOAP.
SoapReflectionImporter	Generuje mapowania na komunikaty zakodowane w formacie SOAP na podstawie typów platformy .NET lub informacji o metodzie usługi sieci Web.
SoapSchemaMember	Reprezentuje pewne atrybuty elementu XSD <part> w dokumencie WSDL do generowania klas z dokumentu.
SoapTypeAttribute	Steruje schematem wygenerowanym przez XmlSerializer, gdy wystąpienie klasy jest serializowane jako kodowany kod XML protokołu SOAP.
UnreferencedObjectEventArgs	Dostarcza dane dla znanego, ale nieoferencjonowanego obiektu znalezionego w zakodowanym strumieniu XML protokołu SOAP podczas deserializacji.
XmlAnyAttributeAttribute	Określa, że element członkowski (pole zwracające tablicę obiektów XmlAttribute) może zawierać dowolne atrybuty XML.
XmlAnyElementAttribute	Określa, że element członkowski (pole zwracające tablicę obiektów XmlElement lub XmlNode) zawiera obiekty reprezentujące dowolny element XML, który nie ma odpowiedniego elementu członkowskiego w obiekcie serializowanym lub deserializowanym.
XmlAnyElementAttributes	Reprezentuje kolekcję XmlAnyElementAttribute obiektów.
XmlArrayAttribute	Określa, że XmlSerializer musi serializacji określonej składowej klasy jako tablicy elementów XML.
XmlArrayItemAttribute	Reprezentuje atrybut określający typy pochodne, które XmlSerializer mogą umieścić w serializacji tablicy.
XmlArrayItemAttributes	Reprezentuje kolekcję XmlArrayItemAttribute obiektów.
XmlAttributeAttribute	Określa, że XmlSerializer musi serializować składową klasy jako atrybut XML.
XmlAttributeEventArgs	Udostępnia dane dla zdarzenia UnknownAttribute.
XmlAttributeOverrides	Umożliwia zastępowanie właściwości, pól i atrybutów klasy w przypadku używania XmlSerializer klasy do serializacji lub deserializacji obiektu.
XmlAttributes	Reprezentuje kolekcję obiektów atrybutów, które kontrolują sposób XmlSerializer serializacji i deserializacji obiektu.
XmlChoiceIdentifierAttribute	Określa, że element członkowski można dodatkowo wykryć przy użyciu wyliczenia.
XmlElementAttribute	Wskazuje, że pole publiczne lub właściwość reprezentuje element XML, gdy XmlSerializer serializuje lub deserializuje obiekt, który go zawiera.
XmlElementAttributes	Reprezentuje kolekcję obiektów używanych XmlElementAttribute przez XmlSerializer obiekt , aby zastąpić domyślny sposób serializacji klasy.
XmlElementEventArgs	Udostępnia dane dla zdarzenia UnknownElement.
XmlEnumAttribute	Określa, w jaki sposób XmlSerializer serializuje element członkowski wyliczenia.
XmlIgnoreAttribute	Instruuje metodę Serialize(TextWriter, Object)XmlSerializer, aby nie serializować pola publicznego lub publicznej wartości właściwości odczytu/zapisu.
XmlIncludeAttribute	Umożliwia XmlSerializer rozpoznawanie typu podczas serializacji lub deserializacji obiektu.
XmlMapping	Obsługuje mapowania między typami .NET i typami danych schematu XML.
XmlMemberMapping	Mapuje jednostkę kodu w metodzie usługi sieci Web .NET na element w komunikacie WSDL (Web Services Description Language).
XmlMembersMapping	Udostępnia mapowania między metodami usługi sieci Web platformy .NET i komunikatami języka WSDL (Web Services Description Language) zdefiniowanymi dla usług sieci Web PROTOKOŁU SOAP.
XmlNamespaceDeclarationsAttribute	Określa, że właściwość docelowa, parametr, wartość zwracana lub składowa klasy zawiera prefiksy skojarzone z przestrzeniami nazw używanymi w dokumencie XML.
XmlNodeEventArgs	Udostępnia dane dla zdarzenia UnknownNode.
XmlReflectionImporter	Generuje mapowania na deklaracje elementów schematu XML, w tym części komunikatów definicji schematu XML (XSD) w dokumencie Web Services Description Language (WSDL) dla typów platformy .NET lub informacji o metodzie usługi sieci Web.
XmlReflectionMember	Udostępnia mapowania między jednostkami kodu w metodach usługi sieci Web platformy .NET i zawartości komunikatów języka WSDL (Web Services Description Language) zdefiniowanych dla usług sieci Web PROTOKOŁU SOAP.
XmlRootAttribute	Kontroluje serializację XML elementu docelowego atrybutu jako główny element XML.
XmlSchemaEnumerator	Umożliwia iterację w kolekcji XmlSchema obiektów.
XmlSchemaExporter	XmlSchema Wypełnia obiekty deklaracjami elementów schematu XML, które znajdują się w obiektach mapowania typów.
XmlSchemaImporter	Generuje wewnętrzne mapowania na typy platformy .NET dla deklaracji elementów schematu XML, w tym części komunikatów XSD literału w dokumencie WSDL.
XmlSchemaProviderAttribute	W przypadku zastosowania do typu przechowuje nazwę statycznej metody typu, która zwraca schemat XML i XmlQualifiedName (lub XmlSchemaType dla typów anonimowych), która kontroluje serializacji typu.
XmlSchemas	Reprezentuje kolekcję schematów XML.
XmlSerializationGeneratedCode	Klasa abstrakcyjna, która jest klasą bazową i XmlSerializationReaderXmlSerializationWriter zawiera metody wspólne dla obu tych typów.
XmlSerializationReader	Steruje deserializacji przez klasę XmlSerializer .
XmlSerializationReader.CollectionFixup	XmlSerializationCollectionFixupCallback Przechowuje wystąpienie delegata oraz dane wejściowe metody, a także dostarcza parametry metody.
XmlSerializationReader.Fixup	XmlSerializationFixupCallback Przechowuje wystąpienie delegata oraz dane wejściowe metody, a także służy jako parametr metody .
XmlSerializationWriter	Reprezentuje abstrakcyjną klasę używaną do kontrolowania serializacji przez klasę XmlSerializer .
XmlSerializer	Serializuje i deserializuje obiekty do i z dokumentów XML. Funkcja XmlSerializer umożliwia kontrolowanie sposobu kodowania obiektów w formacie XML.
XmlSerializerAssemblyAttribute	Zastosowany do serwera proxy klienta usługi sieci Web umożliwia określenie zestawu zawierającego serializatory niestandardowe.
XmlSerializerFactory	Tworzy typizowane wersje elementu XmlSerializer w celu bardziej wydajnej serializacji.
XmlSerializerImplementation	Definiuje czytnik, zapis i metody dla wstępnie wygenerowanych serializatorów.
XmlSerializerNamespaces	Zawiera przestrzenie nazw XML i prefiksy używane XmlSerializer do generowania kwalifikowanych nazw w wystąpieniu dokumentu XML.
XmlSerializerVersionAttribute	Oznacza, że kod został wygenerowany przez infrastrukturę serializacji i można go użyć ponownie w celu zwiększenia wydajności, gdy ten atrybut zostanie zastosowany do zestawu.
XmlTextAttribute	Wskazuje XmlSerializer, że składowa musi być traktowana jako tekst XML, gdy klasa zawierająca ją jest serializowana lub deserializowana.
XmlTypeAttribute	Steruje schematem XML generowanym, gdy obiekt docelowy atrybutu jest serializowany przez XmlSerializer.
XmlTypeMapping	Zawiera mapowanie jednego typu na inny.

Struktury

Nazwa	Opis
XmlDeserializationEvents	Zawiera pola, których można użyć do przekazywania delegatów zdarzeń do metody bezpiecznej Deserialize wątkowo klasy XmlSerializer.

Interfejsy

Nazwa	Opis
IXmlSerializable	Zapewnia niestandardowe formatowanie na potrzeby serializacji i deserializacji XML.
IXmlTextParser	Normalized Ustanawia właściwość do użycia przez infrastrukturę platformy .NET.

Wyliczenia

Nazwa	Opis
CodeGenerationOptions	Określa różne opcje do użycia podczas generowania typów platformy .NET do użycia z usługą sieci Web XML.
XmlMappingAccess	Określa, czy mapowanie jest odczytywane, zapisywane, czy oba.

Delegaci

Nazwa	Opis
UnreferencedObjectEventHandler	Reprezentuje metodę, która obsługuje UnreferencedObject zdarzenie elementu XmlSerializer.
XmlAttributeEventHandler	Reprezentuje metodę, która obsługuje metodę UnknownAttribute.
XmlElementEventHandler	Reprezentuje metodę, która obsługuje UnknownElement zdarzenie elementu XmlSerializer.
XmlNodeEventHandler	Reprezentuje metodę, która obsługuje UnknownNode zdarzenie elementu XmlSerializer.
XmlSerializationCollectionFixupCallback	Delegat używany przez klasę XmlSerializer do deserializacji typów danych XML zakodowanych w formacie SOAP, które są mapowane na kolekcje lub wyliczenia.
XmlSerializationFixupCallback	Delegat używany przez klasę XmlSerializer do deserializacji danych XML zakodowanych za pomocą protokołu SOAP.
XmlSerializationReadCallback	Delegat używany przez klasę XmlSerializer do deserializacji typów z danych XML zakodowanych za pomocą protokołu SOAP, które nie są głównymi danymi XML.
XmlSerializationWriteCallback	Delegat używany przez klasę XmlSerializer do serializacji typów z zakodowanych w formacie SOAP danych XML innych niż główne.

Uwagi

Centralna klasa w przestrzeni nazw jest klasą XmlSerializer . Aby użyć tej klasy, użyj konstruktora XmlSerializer , aby utworzyć wystąpienie klasy przy użyciu typu obiektu do serializacji. Po utworzeniu obiektu XmlSerializer utwórz wystąpienie obiektu w celu serializacji. Należy również utworzyć obiekt, aby zapisać plik w dokumencie lub strumieniu, takim jak Stream, TextWriterlub XmlWriter. Następnie można wywołać metodę Serialize , aby przekonwertować obiekt na dokument XML.

Aby wykonać deserializowanie obiektu z dokumentu XML, utwórz odpowiedni obiekt do odczytania dokumentu lub strumienia (ponownie, a Stream, TextWriterlub XmlWriter). Wywołaj metodę Deserialize podczas rzutowania wynikowego obiektu na typ oryginalnego obiektu (który został serializowany).

Aby dokładniej kontrolować serializacji, przestrzeń nazw zawiera kilka Attribute klas, System.Xml.Serialization które można zastosować do składowych klasy. Jeśli na przykład klasa zawiera składową, która będzie serializowana jako element XML, można zastosować XmlElementAttribute atrybut do składowej. Podczas stosowania atrybutu można określić szczegóły, takie jak rzeczywista nazwa elementu XML przy użyciu ElementName właściwości . Aby uzyskać pełną listę wszystkich atrybutów, zobacz XmlSerializer omówienie klasy.