Atrybuty kontrolujące serializację XML
Atrybuty w poniższej tabeli można zastosować do klas i składowych klas, aby kontrolować sposób XmlSerializer serializacji lub deserializacji wystąpienia klasy. Aby dowiedzieć się, jak te atrybuty kontrolują serializacji XML, zobacz Kontrolowanie serializacji XML przy użyciu atrybutów.
Te atrybuty mogą również kontrolować wiadomości protokołu SOAP literału stylu generowanych przez usługi sieci Web XML. Aby uzyskać więcej informacji na temat stosowania tych atrybutów do metody usług sieci Web XML, zobacz Serializacja XML z usługami sieci Web XML.
Aby uzyskać więcej informacji na temat atrybutów, zobacz Atrybuty.
| Atrybut | Dotyczy | Określa |
|---|---|---|
| XmlAnyAttributeAttribute | Pole publiczne, właściwość, parametru lub zwracanej wartości, która zwraca tablicę XmlAttribute obiektów. | Podczas deserializacji, tablica będzie wypełniona XmlAttribute obiektów, które reprezentują wszystkie atrybuty XML nieznany schematu. |
| XmlAnyElementAttribute | Pole publiczne, właściwość, parametru lub zwracanej wartości, która zwraca tablicę XmlElement obiektów. | Podczas deserializacji, tablica jest wypełniany XmlElement obiekty reprezentujące wszystkie elementy XML nieznany schematu. |
| XmlArrayAttribute | Pole publiczne, właściwość, parametr lub wartość zwracana, która zwraca tablicę obiektów złożonych. | Zostanie wygenerowany tablicy elementów członkowskich jako elementy członkowskie tablicy XML. |
| XmlArrayItemAttribute | Pole publiczne, właściwość, parametr lub wartość zwracana, która zwraca tablicę obiektów złożonych. | Typy pochodne, które mogą być wstawiane do tablicy. Zwykle stosowane w połączeniu z elementem XmlArrayAttribute. |
| XmlAttributeAttribute | Pole publiczne, właściwość, parametru lub wartości zwracanej. | Element członkowski będzie serializowana jako atrybut XML. |
| XmlChoiceIdentifierAttribute | Pole publiczne, właściwość, parametru lub wartości zwracanej. | Element członkowski może dodatkowo rozróżniane przy użyciu wyliczenia. |
| XmlElementAttribute | Pole publiczne, właściwość, parametru lub wartości zwracanej. | Pole lub właściwość będzie serializowana jako XML element. |
| XmlEnumAttribute | Pole publicznej jest identyfikatorem wyliczenia. | Nazwa elementu element członkowski wyliczenia. |
| XmlIgnoreAttribute | Właściwości publiczne i pola. | Właściwości lub pól mają być ignorowane, gdy klasa zawierająca jest serializowana. |
| XmlIncludeAttribute | Publiczna uzyskiwany deklaracje klas i zwracanymi wartościami metod publicznych w dokumentach sieci Web Services Description Language (WSDL). | Klasa mają zostać uwzględnione podczas generowania schematów (do rozpoznany po serializacji). |
| XmlRootAttribute | Klasa publiczna deklaracji. | Formanty XML serializacji w celu atrybutu jako element główny XML. Użyj atrybutu do dalszego określenia nazwy obszaru nazw i elementu. |
| XmlTextAttribute | Właściwości publiczne i pola. | Właściwości lub pól powinien zostać Zserializowany jako tekst XML. |
| XmlTypeAttribute | Klasa publiczna deklaracji. | Nazwa i nazw typu XML. |
| ObsoleteAttribute | Właściwości publiczne i pola. | Właściwość lub pole zostanie zignorowane, gdy klasa zawierająca jest serializowana. |
Oprócz tych atrybutów, które znajdują się w System.Xml.Serialization przestrzeni nazw, można również zastosować DefaultValueAttribute atrybut do pola. Parametr DefaultValueAttribute ustawia wartość, która zostanie automatycznie przypisana do elementu członkowskiego, jeśli nie zostanie określona żadna wartość.
Aby kontrolować zakodowaną serializacji XML protokołu SOAP, zobacz Atrybuty, które kontrolują zakodowaną serializacji PROTOKOŁU SOAP.
