Atrybuty kontrolujące serializację XML

  • Artykuł

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.

Zobacz też