Udostępnij za pośrednictwem

Atrybuty kontrolujące serializację XML

Atrybuty przedstawione w poniższej tabeli można stosować do klas i elementów klas, aby kontrolować sposób, w jaki XmlSerializer serializuje lub deserializuje 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ż służyć do kontrolowania komunikatów SOAP w stylu dosłownym generowanych przez usługę sieciową 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 Odnosi się do Określa
XmlAnyAttributeAttribute Pole publiczne, właściwość, parametr lub wartość zwracana, która zwraca tablicę XmlAttribute obiektów. Podczas deserializacji tablica zostanie wypełniona obiektami reprezentującymi XmlAttribute wszystkie atrybuty XML nieznane schematowi.
XmlAnyElementAttribute Pole publiczne, właściwość, parametr lub wartość zwracana, która zwraca tablicę XmlElement obiektów. Podczas deserializacji tablica jest wypełniona obiektami reprezentującymi XmlElement wszystkie elementy XML nieznane schematowi.
XmlArrayAttribute Pole publiczne, właściwość, parametr lub wartość zwracana, która zwraca tablicę obiektów złożonych. Elementy członkowskie tablicy zostaną wygenerowane 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ć umieszczone w tablicy. Zwykle stosowane w połączeniu z elementem XmlArrayAttribute.
XmlAttributeAttribute Pole publiczne, właściwość, parametr lub wartość zwracana. Członek zostanie zaserializowany jako atrybut XML.
XmlChoiceIdentifierAttribute Pole publiczne, właściwość, parametr lub wartość zwracana. Członek może być dalej doprecyzowany przy użyciu wyliczenia.
XmlElementAttribute Pole publiczne, właściwość, parametr lub wartość zwracana. Pole lub właściwość zostaną serializowane jako element XML.
XmlEnumAttribute Pole publiczne, które jest identyfikatorem wyliczenia. Nazwa członka wyliczenia.
XmlIgnoreAttribute Właściwości publiczne i pola. Właściwość lub pole powinny być ignorowane, gdy klasa zawierająca jest serializowana.
XmlIncludeAttribute Deklaracje publicznych klas pochodnych i wartości zwracane przez publiczne metody dla dokumentów WSDL (Web Services Description Language). Klasa powinna zostać uwzględniona podczas generowania schematów (do rozpoznawania w przypadku serializacji).
XmlRootAttribute Deklaracje klas publicznych. Kontroluje serializację XML elementu docelowego atrybutu jako główny element XML. Użyj atrybutu , aby dodatkowo określić przestrzeń nazw i nazwę elementu.
XmlTextAttribute Właściwości publiczne i pola. Właściwość lub pole powinny być serializowane jako tekst XML.
XmlTypeAttribute Deklaracje klas publicznych. Nazwa i przestrzeń nazw typu XML.
ObsoleteAttribute Właściwości publiczne i pola. Właściwość lub pole jest ignorowane, kiedy zawierająca ją klasa 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ą serializację XML protokołu SOAP, odnieś się do Atrybuty, które kontrolują zakodowaną serializację protokołu SOAP.

Zobacz także