Attribute zur Steuerung der XML-Serialisierung
Sie können die in der folgenden Tabelle aufgeführten Attribute auf Klassen und Klassenmember anwenden, um zu steuern, wie Instanzen der Klasse durch die XmlSerializer-Klasse serialisiert bzw. deserialisiert werden. Wie die XML-Serialisierung mithilfe dieser Attribute gesteuert wird, wird unter Steuern der XML-Serialisierung mit Attributen beschrieben.
Diese Attribute können auch verwendet werden, um die durch einen XML-Webdienst generierten literalen SOAP-Nachrichten zu steuern. Weitere Informationen zur Anwendung dieser Attribute auf eine XML-Webdienstmethode finden Sie unter XML-Serialisierung mit XML-Webdiensten.
Weitere Informationen zu Attributen finden Sie unter Extending Metadata Using Attributes.
| Attribut | Anwendung | Bedeutung |
|---|---|---|
Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert, wodurch ein Array von XmlAttribute-Objekten zurückgegeben wird. |
Beim Deserialisieren wird das Array mit XmlAttribute-Objekten gefüllt, die für alle im Schema unbekannten XML-Attribute stehen. |
|
Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert, wodurch ein Array von XmlElement-Objekten zurückgegeben wird. |
Beim Deserialisieren wird das Array mit XmlElement-Objekten gefüllt, die für alle im Schema unbekannten XML-Elementen stehen. |
|
Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert, wodurch ein Array von komplexen Objekten zurückgegeben wird. |
Die Member des Arrays werden als Member eines XML-Arrays generiert. |
|
Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert, wodurch ein Array von komplexen Objekten zurückgegeben wird. |
Die abgeleiteten Typen, die in ein Array eingefügt werden können. Wird in der Regel in Verbindung mit einem XmlArrayAttribute-Objekt angewendet. |
|
Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert. |
Der Member wird als XML-Attribut serialisiert. |
|
Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert. |
Der Member kann durch Verwendung einer Enumeration eindeutig bestimmt werden. |
|
Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert. |
Das Feld oder die Eigenschaft wird als XML-Element serialisiert. |
|
Öffentliches Feld, das ein Enumerationsbezeichner ist. |
Der Elementname eines Enumerationsmembers. |
|
Öffentliche Eigenschaften und Felder. |
Die Eigenschaft oder das Feld wird beim Serialisieren der Klasse, in dem sie bzw. es enthalten ist, ignoriert. |
|
Öffentliche abgeleiteten Klassendeklarationen, und Rückgabewerte von öffentlichen Methoden für WSDL-Dokumente (Web Services Description Language). |
Diese Klasse wird beim Generieren von Schemas eingeschlossen (und daher bei der Serialisierung erkannt). |
|
Deklarationen öffentlicher Klassen. |
Steuert die XML-Serialisierung des Attributziels als XML-Stammelement. Mit diesem Attribut können Sie Namespace und Elementnamen genauer angeben. |
|
Öffentliche Eigenschaften und Felder. |
Die Eigenschaft oder das Feld soll als XML-Text serialisiert werden. |
|
Deklarationen öffentlicher Klassen. |
Der Name und Namespace des XML-Typs. |
Zusätzlich zu diesen Attributen, die alle im System.Xml.Serialization-Namespace enthalten sind, können Sie auch das System.ComponentModel.DefaultValueAttribute-Attribut auf ein Feld anwenden. Durch DefaultValueAttribute wird der Wert festgelegt, der dem Member automatisch zugewiesen wird, falls kein Wert angegeben wurde.
Informationen zur Steuerung der XML-Serialisierung von codiertem SOAP finden Sie unterAttribute zur Steuerung der Serialisierung von codiertem SOAP.
Siehe auch
Aufgaben
Gewusst wie: Angeben eines alternativen Elementnamens für einen XML-Stream
Gewusst wie: Serialisieren eines Objekts
Gewusst wie: Deserialisieren eines Objekts
Referenz
Konzepte
Steuern der XML-Serialisierung mit Attributen
Weitere Ressourcen
.gif)
Copyright © 2007 by Microsoft Corporation. Alle Rechte vorbehalten.