System.Xml.Serialization Namespace

Enthält Klassen, die zur Serialisierung von Objekten in Dokumente oder Streams im XML-Format verwendet werden.

Klassen

CodeIdentifier	Stellt statische Methoden bereit, um Eingabetext in Namen für Codeentitäten zu konvertieren.
CodeIdentifiers	Verwaltet eine Gruppe von Namen für entsprechende Codeentitäten oder Typzuordnungen, die von der Serialisierungsinfrastruktur von .NET generiert werden.
ImportContext	Beschreibt den Kontext, in dem eine Gruppe von Schemas an .NET-Codeentitäten gebunden wird.
SchemaImporter	Beschreibt einen Schemaimporter.
SoapAttributeAttribute	Gibt an, dass XmlSerializer den Klassenmember als codiertes SOAP-Attribut serialisieren muss.
SoapAttributeOverrides	Ermöglicht das Überschreiben von Attributen, die auf Eigenschaften, Felder und Klassen beim Serialisieren oder Deserialisieren eines Objekts als codiertes SOAP durch einen XmlSerializer angewendet werden.
SoapAttributes	Stellt eine Auflistung von Attributobjekten dar, die das Serialisieren und Deserialisieren von SOAP-Methoden durch XmlSerializer steuern.
SoapElementAttribute	Gibt an, dass XmlSerializer den öffentlichen Memberwert als codiertes SOAP XML-Element serialisieren soll.
SoapEnumAttribute	Steuert die Art, in der XmlSerializer einen Enumerationsmember serialisiert.
SoapIgnoreAttribute	Weist XmlSerializer an, den Eigenschaftswert des öffentlichen Felds oder den öffentlichen Lese-/Schreibeigenschaftswert nicht zu serialisieren.
SoapIncludeAttribute	Ermöglicht dem XmlSerializer das Erkennen eines Typs beim Serialisieren oder Deserialisieren eines Objekts als codiertes SOAP-XML.
SoapReflectionImporter	Generiert Zuordnungen zu SOAP-codierten Nachrichten von .NET-Typen oder Informationen zu Webdienstmethoden.
SoapSchemaMember	Stellt bestimmte Attribute eines XSD-<part>-Elements in einem WSDL-Dokument zum Generieren von Klassen aus dem Dokument dar.
SoapTypeAttribute	Steuert das Schema, das von XmlSerializer beim Serialisieren einer Klasseninstanz als SOAP-codiertes XML generiert wird.
UnreferencedObjectEventArgs	Stellt Daten für ein in einem codierten SOAP-XML-Stream bei der Deserialisierung gefundenes Objekt bereit, das bekannt ist, auf das aber nicht verwiesen wird.
XmlAnyAttributeAttribute	Gibt an, dass der Member (ein Feld, das ein Array von XmlAttribute-Objekten zurückgibt) XML-Attribute enthalten kann.
XmlAnyElementAttribute	Gibt an, dass der Member (ein Feld, das ein Array von XmlElement-Objekten oder XmlNode-Objekten zurückgibt) Objekte enthält, die XML-Elemente darstellen, die keine entsprechenden Member in dem zu serialisierenden oder zu deserialisierenden Objekt aufweisen.
XmlAnyElementAttributes	Stellt eine Auflistung von XmlAnyElementAttribute-Objekten dar.
XmlArrayAttribute	Gibt an, dass XmlSerializer ein spezieller Klassenmember als Array von XML-Elementen serialisieren muss.
XmlArrayItemAttribute	Stellt ein Attribut dar, das die abgeleiteten Typen angibt, welche der XmlSerializer in ein serialisiertes Array einfügen kann.
XmlArrayItemAttributes	Stellt eine Auflistung von XmlArrayItemAttribute-Objekten dar.
XmlAttributeAttribute	Gibt an, dass XmlSerializer den Klassenmember als XML-Attribut serialisieren muss.
XmlAttributeEventArgs	Stellt Daten für das UnknownAttribute-Ereignis bereit.
XmlAttributeOverrides	Ermöglicht das Überschreiben der Attribute von Eigenschaften, Feldern und Klassen beim Serialisieren oder Deserialisieren eines Objekts mit XmlSerializer.
XmlAttributes	Stellt eine Auflistung von Attributobjekten dar, die steuern, wie der XmlSerializer Objekte serialisiert und deserialisiert.
XmlChoiceIdentifierAttribute	Gibt an, dass der Member durch Verwendung einer Enumeration genauer erkannt werden kann.
XmlElementAttribute	Gibt an, dass ein öffentliches Feld oder eine öffentliche Eigenschaft beim Serialisieren bzw. Deserialisieren des Objekts, in dem diese enthalten sind, durch XmlSerializer ein XML-Element darstellt.
XmlElementAttributes	Stellt eine Auflistung mit XmlElementAttribute-Objekten dar, die vom XmlSerializer-Element verwendet werden, um die Standardmethode für die Serialisierung einer Klasse zu überschreiben.
XmlElementEventArgs	Stellt Daten für das UnknownElement-Ereignis bereit.
XmlEnumAttribute	Steuert die Art, in der XmlSerializer einen Enumerationsmember serialisiert.
XmlIgnoreAttribute	Weist die Serialize(TextWriter, Object)-Methode von XmlSerializer an, den Eigenschaftswert des öffentlichen Felds oder des öffentlichen Lese-/Schreibzugriffs nicht zu serialisieren.
XmlIncludeAttribute	Ermöglicht dem XmlSerializer das Erkennen eines Typs beim Serialisieren oder Deserialisieren eines Objekts.
XmlMapping	Unterstützt Zuordnungen zwischen .NET-Typen und XML-Schemadatentypen.
XmlMemberMapping	Ordnet eine Codeentität in einer .NET-Webdienstmethode einem Element in einer WSDL-Meldung (Web Services Description Language) zu.
XmlMembersMapping	Stellt Zuordnungen zwischen .NET-Webdienstmethoden und WSDL-Meldungen (Web Services Description Language) her, die für SOAP-Webdienste definiert werden.
XmlNamespaceDeclarationsAttribute	Gibt an, dass die Zieleigenschaft, der Parameter, der Rückgabewert oder der Member Präfixe enthält, die Namespaces zugeordnet sind, welche innerhalb eines XML-Dokuments verwendet werden.
XmlNodeEventArgs	Stellt Daten für das UnknownNode-Ereignis bereit.
XmlReflectionImporter	Generiert Zuordnungen zu XML-Schemaelementdeklarationen, einschließlich XSD-Nachrichtenteilen (XML-Schema Definition) in einem WDSL-Dokument (Web Services Description Language), für .NET-Typen oder Informationen zu Webdienstmethoden.
XmlReflectionMember	Stellt Zuordnungen zwischen Codeentitäten in .NET-Webservicemethoden und dem Inhalt der WSDL-Meldungen (Web Services Description Language) her, die für SOAP-Webdienste definiert werden.
XmlRootAttribute	Steuert die XML-Serialisierung des Attributziels als XML-Stammelement.
XmlSchemaEnumerator	Ermöglicht das Durchlaufen einer Auflistung von XmlSchema-Objekten.
XmlSchemaExporter	Füllt XmlSchema-Objekte mit XML-Schemaelement-Deklarationen auf, die in typzuordnenden Objekten gefunden werden.
XmlSchemaImporter	Generiert interne Zuordnungen zwischen .NET-Typen und XML-Schema-Elementdeklarationen einschließlich literalen XSD-Meldungsteilen in WSDL-Dokumenten.
XmlSchemaProviderAttribute	Speichert bei Anwendung auf einen Typ den Namen einer statischen Methode des Typs, der ein XML-Schema und ein XmlQualifiedName-Element (oder bei anonymen Typen ein XmlSchemaType-Element) zurückgibt, das die Serialisierung des Typs steuert.
XmlSchemas	Stellt die Auflistung von XML-Schemas dar.
XmlSerializationGeneratedCode	Eine abstrakte Klasse, die die Basisklasse für XmlSerializationReader und XmlSerializationWriter darstellt und Methoden enthält, die beiden Typen gemeinsam sind.
XmlSerializationReader	Steuert die Deserialisierung durch die XmlSerializer-Klasse.
XmlSerializationReader.CollectionFixup	Enthält eine Instanz eines XmlSerializationCollectionFixupCallback-Delegaten und die Eingaben der Methoden. Außerdem werden die Parameter der Methode bereitgestellt.
XmlSerializationReader.Fixup	Enthält eine Instanz des XmlSerializationFixupCallback-Delegaten sowie die Eingaben der Methode. Außerdem wird es als Parameter für die Methode verwendet.
XmlSerializationWriter	Stellt eine abstrakte Klasse zur Steuerung der Serialisierung durch die XmlSerializer-Klasse.
XmlSerializer	Serialisiert und deserialisiert Objekte in und aus XML-Dokumenten. Mit XmlSerializer können Sie steuern, wie Objekte in XML codiert werden.
XmlSerializerAssemblyAttribute	Wird auf einen Clientproxy für Webdienste angewendet. Ermöglicht das Angeben einer Assembly mit benutzerdefinierten Serialisierungsprogrammen.
XmlSerializerFactory	Erstellt typisierte Versionen von XmlSerializer für eine effizientere Serialisierung.
XmlSerializerImplementation	Definiert Reader, Writer und Methoden für zuvor generierte Serialisierungsprogramme.
XmlSerializerNamespaces	Enthält die XML-Namespaces und Präfixe, die von XmlSerializer zum Generieren vollständiger Namen in einer XML-Dokumentinstanz verwendet werden.
XmlSerializerVersionAttribute	Wenn dieses Attribut auf eine Assembly angewendet wird, bedeutet dies, dass der Code von der Serialisierungsinfrastruktur generiert wurde und zum Zweck der Leistungssteigerung wiederverwendet werden kann.
XmlTextAttribute	Gibt dem XmlSerializer an, dass der Member beim Serialisieren oder Deserialisieren der Klasse, in der er enthalten ist, als XML-Text behandelt werden muss.
XmlTypeAttribute	Steuert das XML-Schema, das generiert wird, wenn das Attributziel vom XmlSerializer serialisiert wird.
XmlTypeMapping	Enthält eine Zuordnung eines Typs zu einem anderen.

Strukturen

XmlDeserializationEvents

Enthält Felder, die zum Übergeben von Ereignisdelegaten an eine threadsichere Deserialize-Methode des XmlSerializer verwendet werden können.

Schnittstellen

IXmlSerializable	Stellt eine benutzerdefinierte Formatierung für die XML-Serialisierung und -Deserialisierung bereit.
IXmlTextParser	Richtet eine Normalized-Eigenschaft zur Verwendung durch die .NET-Infrastruktur ein.

Enumerationen

CodeGenerationOptions	Gibt verschiedene Optionen an, die beim Generieren von .NET-Typen für einen XML-Webdienst verwendet werden.
XmlMappingAccess	Gibt an, ob eine Zuordnung über Lese- oder Schreibzugriff oder über beides verfügt.

Delegaten

UnreferencedObjectEventHandler	Stellt die Methode dar, die das UnreferencedObject-Ereignis einer XmlSerializer-Klasse behandelt.
XmlAttributeEventHandler	Stellt die Methode dar, die das UnknownAttribute behandelt.
XmlElementEventHandler	Stellt die Methode dar, die das UnknownElement-Ereignis einer XmlSerializer-Klasse behandelt.
XmlNodeEventHandler	Stellt die Methode dar, die das UnknownNode-Ereignis einer XmlSerializer-Klasse behandelt.
XmlSerializationCollectionFixupCallback	Ein Delegat, der von der XmlSerializer-Klasse zum Deserialisieren von SOAP-codierten XML-Datentypen verwendet wird, denen Auflistungen oder Enumerationen zugeordnet sind.
XmlSerializationFixupCallback	Der von der XmlSerializer-Klasse für die Deserialisierung SOAP-codierter XML-Daten verwendete Delegat.
XmlSerializationReadCallback	Ein von der XmlSerializer-Klasse verwendeter Delegat, mit dem Typen aus SOAP-codierten XML-Daten, die keine Stammelemente darstellen, deserialisiert werden können.
XmlSerializationWriteCallback	Ein von der XmlSerializer-Klasse verwendeter Delegat, mit dem Typen aus SOAP-codierten XML-Daten, die keine Stammelemente darstellen, serialisiert werden können.

Hinweise

Die zentrale Klasse im Namespace ist die XmlSerializer -Klasse. Um diese Klasse zu verwenden, verwenden Sie den XmlSerializer Konstruktor, um eine instance der -Klasse unter Verwendung des Typs des zu serialisierenden Objekts zu erstellen. Erstellen Sie nach der Erstellung eine XmlSerializer instance des zu serialisierenden Objekts. Sie müssen auch ein -Objekt erstellen, um die Datei in ein Dokument oder Einen Stream zu schreiben, z. B. ein Stream, TextWriteroder XmlWriter. Anschließend können Sie die Serialize -Methode aufrufen, um das Objekt in ein XML-Dokument zu konvertieren.

Um ein Objekt aus einem XML-Dokument zu deserialisieren, erstellen Sie ein geeignetes Objekt zum Lesen des Dokuments oder Datenstroms (wiederum ein Stream, TextWriteroder XmlWriter). Rufen Sie die Deserialize -Methode auf, während Sie das resultierende Objekt in den Typ des ursprünglichen Objekts umwandeln (das serialisiert wurde).

Um die Serialisierung weiter zu steuern, enthält der System.Xml.Serialization Namespace mehrere Attribute Klassen, die auf Member einer Klasse angewendet werden können. Wenn eine Klasse beispielsweise einen Member enthält, der als XML-Element serialisiert wird, können Sie das XmlElementAttribute Attribut auf das Element anwenden. Beim Anwenden des Attributs können Sie Details wie den tatsächlichen XML-Elementnamen mithilfe der ElementName -Eigenschaft angeben. Eine vollständige Liste aller Attribute finden Sie in der XmlSerializer Klassenübersicht.