System.Xml.Serialization-Namespace

Der System.Xml.Serialization-Namespace enthält Klassen, die zum Serialisieren von Objekten in Dokumente oder Streams im XML-Format verwendet werden.

Die zentrale Klasse im Namespace ist die XmlSerializer-Klasse. Wenn Sie diese Klasse verwenden möchten, erstellen Sie mit dem XmlSerializer-Konstruktor unter Verwendung des Typs des zu serialisierenden Objekts eine Instanz der Klasse. Sobald ein XmlSerializer erstellt ist, erstellen Sie eine Instanz des zu serialisierenden Objekts. Sie müssen auch ein Objekt erstellen, um die Datei in ein Dokument oder einen Stream zu schreiben, wie Stream, TextWriter oder XmlWriter. Dann können Sie die Serialize-Methode aufrufen, um das Objekt in ein XML-Dokument zu konvertieren.

Zum Deserialisieren eines Objekts aus einem XML-Dokument erstellen Sie ein geeignetes Objekt, um das Dokument oder den Stream zu lesen (wieder Stream, TextWriter oder XmlWriter). Rufen Sie die Deserialize-Methode auf, während das resultierende Objekt in den Typ des Originalobjekts (das serialisiert wurde) umgewandelt wird.

Zur weiteren Steuerung der Serialisierung 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 dem Member das XmlElementAttribute-Attribut zuweisen. Wenn das Attribut zugewiesen wird, können Sie Details wie den gegenwärtigen XML-Elementnamen mithilfe der ElementName-Eigenschaft angeben. Eine vollständige Liste aller Attribute finden Sie in der Übersicht über die XmlSerializer-Klasse.

Klassen

	Klasse	Beschreibung
	CodeExporter	Stellt eine Klasse dar, die aus einer XML-Darstellung einer Datenstruktur Proxycode generieren kann.
	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 Framework generiert werden.
	ImportContext	Beschreibt den Kontext, in dem eine Gruppe von Schemas an .NET Framework-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.
	SoapCodeExporter	Generiert Typen- und Attributdeklarationen aus internen Typzuordnungsinformationen für SOAP-codierte Nachrichtenteile, die in einem WSDL-Dokument definiert sind.
	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 Eigenschaftenwert des öffentlichen Felds oder den öffentlichen Lese-/Schreibeigenschaftenwert 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 Framework-Typen oder Informationen zu Webdienstmethoden.
	SoapSchemaExporter	Füllt XmlSchema-Objekte mit XML-Schema-Datentypdefinitionen für .NET Framework-Typen, die mit SOAP-Codierung serialisiert werden.
	SoapSchemaImporter	Wird in .NET Framework zum Generieren interner Zuordnungen zu .NET Framework-Typen für SOAP-Nachrichtenteile in einem WSDL-Dokument verwendet.
	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	Gibt die abgeleiteten Typen an, die von XmlSerializer in einem serialisierten Array positioniert werden können.
	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 Verwenden einer Enumeration eindeutig bestimmt werden kann.
	XmlCodeExporter	Generiert Typen und Attributdeklarationen aus internen Typzuordnungsinformationen für Deklarationen von XML-Schemaelementen.
	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 von XmlElementAttribute-Objekten dar, die vom XmlSerializer zum Überschreiben des Standardverfahrens für die Serialisierung einer Klasse verwendet wird.
	XmlElementEventArgs	Stellt Daten für das UnknownElement-Ereignis bereit.
	XmlEnumAttribute	Steuert die Art, in der XmlSerializer einen Enumerationsmember serialisiert.
	XmlIgnoreAttribute	Weist die Serialize-Methode von XmlSerializer an, den Eigenschaftenwert 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 Framework-Typen und XML-Schemadatentypen.
	XmlMemberMapping	Ordnet eine Codeentität in einer .NET Framework-Webdienstmethode einem Element in einer WSDL-Meldung (Web Services Description Language) zu.
	XmlMembersMapping	Stellt Zuordnungen zwischen .NET Framework-Webdienstmethoden und WSDL-Meldungen (Web Services Description Language) her, die für SOAP-Webdienste definiert werden.
	XmlNamespaceDeclarationsAttribute	Gibt an, dass Zieleigenschaft, Zielparameter, Zielrückgabewert oder Zielklassenmember Präfixe enthalten, die den innerhalb eines XML-Dokuments verwendeten Namespaces zugeordnet 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 Framework-Typen oder Informationen zu Webdienstmethoden.
	XmlReflectionMember	Stellt Zuordnungen zwischen Codeentitäten in .NET Framework-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 die Iteration über 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 Framework-Typen und XML-Schema-Elementdeklarationen einschließlich literalen XSD-Meldungsteilen in WSDL-Dokumenten.
	XmlSchemaProviderAttribute	Bei Anwendung auf einen Typ wird der Name einer statischen Methode des Typs gespeichert, der ein XML-Schema und einen XmlQualifiedName zurückgibt, der die Serialisierung des Typs steuert.
	XmlSchemas	Stellt die Auflistung der 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	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.

Schnittstellen

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

Strukturen

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

Delegaten

	Delegat	Beschreibung
	UnreferencedObjectEventHandler	Stellt die Methode dar, die das UnreferencedObject-Ereignis einer XmlSerializer behandelt.
	XmlAttributeEventHandler	Stellt die Methode dar, die UnknownAttribute behandelt.
	XmlElementEventHandler	Stellt die Methode dar, die das UnknownElement-Ereignis einer XmlSerializer behandelt.
	XmlNodeEventHandler	Stellt die Methode dar, die das UnknownNode-Ereignis einer XmlSerializer 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.

Enumerationen

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