Kenmerken die XML-serialisatie bepalen
U kunt de kenmerken in de volgende tabel toepassen op klassen en klasseleden om te bepalen hoe een XmlSerializer exemplaar van de klasse wordt geserialiseerd of gedeserialiseerd. Als u wilt weten hoe deze kenmerken XML-serialisatie beheren, raadpleegt u Xml-serialisatie beheren met behulp van kenmerken.
Deze kenmerken kunnen ook worden gebruikt om de letterlijke SOAP-berichten te beheren die worden gegenereerd door een XML-webservice. Zie XML-serialisatie met XML-webservices voor meer informatie over het toepassen van deze kenmerken op een XML-webservicemethode.
Zie Kenmerken voor meer informatie over kenmerken.
Kenmerk | Van toepassing op | Hiermee geeft u |
---|---|---|
XmlAnyAttributeAttribute | Openbaar veld, eigenschap, parameter of retourwaarde die een matrix met XmlAttribute objecten retourneert. | Bij het deserialiseren wordt de matrix gevuld met XmlAttribute objecten die alle XML-kenmerken vertegenwoordigen die onbekend zijn voor het schema. |
XmlAnyElementAttribute | Openbaar veld, eigenschap, parameter of retourwaarde die een matrix met XmlElement objecten retourneert. | Bij het deserialiseren wordt de matrix gevuld met XmlElement objecten die alle XML-elementen vertegenwoordigen die onbekend zijn bij het schema. |
XmlArrayAttribute | Openbaar veld, eigenschap, parameter of retourwaarde die een matrix met complexe objecten retourneert. | De leden van de matrix worden gegenereerd als leden van een XML-matrix. |
XmlArrayItemAttribute | Openbaar veld, eigenschap, parameter of retourwaarde die een matrix met complexe objecten retourneert. | De afgeleide typen die in een matrix kunnen worden ingevoegd. Meestal toegepast in combinatie met een XmlArrayAttribute. |
XmlAttributeAttribute | Openbaar veld, eigenschap, parameter of retourwaarde. | Het lid wordt geserialiseerd als een XML-kenmerk. |
XmlChoiceIdentifierAttribute | Openbaar veld, eigenschap, parameter of retourwaarde. | Het lid kan verder ondubbelzinnig worden gemaakt met behulp van een opsomming. |
XmlElementAttribute | Openbaar veld, eigenschap, parameter of retourwaarde. | Het veld of de eigenschap wordt geserialiseerd als een XML-element. |
XmlEnumAttribute | Openbaar veld dat een opsommings-id is. | De elementnaam van een opsommingslid. |
XmlIgnoreAttribute | Openbare eigenschappen en velden. | De eigenschap of het veld moet worden genegeerd wanneer de bevatde klasse wordt geserialiseerd. |
XmlIncludeAttribute | Declaraties van openbare afgeleide klassen en retourneren waarden van openbare methoden voor WSDL-documenten (Web Services Description Language). | De klasse moet worden opgenomen bij het genereren van schema's (te herkennen wanneer ze worden geserialiseerd). |
XmlRootAttribute | Declaraties van openbare klassen. | Hiermee bepaalt u de XML-serialisatie van het kenmerkdoel als een XML-hoofdelement. Gebruik het kenmerk om de naamruimte en elementnaam verder op te geven. |
XmlTextAttribute | Openbare eigenschappen en velden. | De eigenschap of het veld moet worden geserialiseerd als XML-tekst. |
XmlTypeAttribute | Declaraties van openbare klassen. | De naam en naamruimte van het XML-type. |
ObsoleteAttribute | Openbare eigenschappen en velden. | De eigenschap of het veld wordt genegeerd wanneer de bevatde klasse wordt geserialiseerd. |
Naast deze kenmerken, die allemaal in de System.Xml.Serialization naamruimte worden gevonden, kunt u het DefaultValueAttribute kenmerk ook toepassen op een veld. De DefaultValueAttribute stelt de waarde in die automatisch wordt toegewezen aan het lid als er geen waarde is opgegeven.
Als u gecodeerde SOAP XML-serialisatie wilt beheren, raadpleegt u Kenmerken die gecodeerde SOAP-serialisatie beheren.