Атрибуты управления сериализацией XML

  • Статья

Для управления способом, с помощью которого XmlSerializer сериализует или десериализует экземпляр класса, к классам и членам класса можно применять атрибуты, указанные в следующей таблице. Сведения о том, как эти атрибуты управляют XML-сериализацией, см. в разделе Управление сериализацией XML с использованием атрибутов.

Эти атрибуты можно также использовать для управления литеральным стилем сообщений SOAP, генерируемых XML-веб-службой. Дополнительные сведения о применении этих атрибутов для существующего метода XML-веб-служб см. в разделе Сериализация XML с использованием XML-веб-служб.

Дополнительные сведения об атрибутах см. в разделе Атрибуты.

Атрибут Применяется к Указывает
XmlAnyAttributeAttribute Открытое поле, свойство, параметр или возвращаемое значение, которое возвращает массив объектов XmlAttribute. Во время десериализации массив будет заполняться объектами XmlAttribute, представляющими все атрибуты XML, не известные для схемы.
XmlAnyElementAttribute Открытое поле, свойство, параметр или возвращаемое значение, которое возвращает массив объектов XmlElement. Во время десериализации массив заполняется объектами XmlElement, представляющими все элементы XML, не известные для схемы.
XmlArrayAttribute Открытое поле, свойство, параметр или возвращаемое значение, которое возвращает массив сложных объектов. Члены массива создаются как члены массива XML.
XmlArrayItemAttribute Открытое поле, свойство, параметр или возвращаемое значение, которое возвращает массив сложных объектов. Производные типы, которые могут быть размещены в массиве. Обычно используется совместно с XmlArrayAttribute.
XmlAttributeAttribute Открытое поле, свойство, параметр или возвращаемое значение. Член должен быть сериализован как атрибут XML.
XmlChoiceIdentifierAttribute Открытое поле, свойство, параметр или возвращаемое значение. Член может быть однозначно определен перечислением.
XmlElementAttribute Открытое поле, свойство, параметр или возвращаемое значение. Поле или свойство сериализуется как элемент XML.
XmlEnumAttribute Открытое поле, являющееся идентификатором перечисления. Имя элемента члена перечисления.
XmlIgnoreAttribute Открытые свойства и поля. Свойство или поле должно игнорироваться при сериализации содержащего его класса.
XmlIncludeAttribute Объявления открытых производных классов и возвращаемые значения открытых методов для документов WSDL. При создании схем класс должен быть включен (чтобы его можно было распознать во время сериализации).
XmlRootAttribute Объявления открытых классов. Управляет XML-сериализацией конечного объекта атрибута как корневого XML-элемента. Используйте атрибут, чтобы подробнее указать пространство имен и имя элемента.
XmlTextAttribute Открытые свойства и поля. Свойство или поле сериализуется как текст XML.
XmlTypeAttribute Объявления открытых классов. Имя и пространство имен типа XML.
ObsoleteAttribute Открытые свойства и поля. Свойство или поле будет игнорироваться при сериализации содержащего класса.

Кроме этих атрибутов, которые располагаются в пространстве имен System.Xml.Serialization, к полю можно применять атрибут DefaultValueAttribute. Атрибут DefaultValueAttribute задает значение, которое автоматически назначается члену, если значение не указано.

Дополнительные сведения см. в разделе Атрибуты управления сериализацией с кодировкой SOAP.

См. также