Атрибуты управления XML-сериализацией
Для управления способом, с помощью которого XmlSerializer сериализует или десериализует экземпляр класса, к классам и членам класса можно применять атрибуты, указанные в следующей таблице. Дополнительные сведения о том, как эти атрибуты управляют сериализацией XML, см. в разделе Управление XML-сериализацией с использованием атрибутов.
Эти атрибуты можно также использовать для управления литеральным стилем сообщений SOAP, генерируемых XML-веб-службой. Дополнительные сведения о применении этих атрибутов для существующего метода XML-веб-служб см. в разделе XML-сериализация с использованием XML-веб-служб.
Дополнительные сведения об атрибутах см. в разделе Extending Metadata Using Attributes.
| Атрибут | Применимость | Что определяет |
|---|---|---|
Открытое поле, свойство, параметр или возвращаемое значение, которое возвращает массив объектов XmlAttribute. |
Во время десериализации массив будет заполняться объектами XmlAttribute, представляющими все атрибуты XML, не известные для схемы. |
|
Открытое поле, свойство, параметр или возвращаемое значение, которое возвращает массив объектов XmlElement. |
Во время десериализации массив заполняется объектами XmlElement, представляющими все элементы XML, не известные для схемы. |
|
Открытое поле, свойство, параметр или возвращаемое значение, которое возвращает массив сложных объектов. |
Члены массива создаются как члены массива XML. |
|
Открытое поле, свойство, параметр или возвращаемое значение, которое возвращает массив сложных объектов. |
Производные типы, которые могут быть размещены в массиве. Обычно используется совместно с XmlArrayAttribute. |
|
Открытое поле, свойство, параметр или возвращаемое значение. |
Член должен быть сериализован как атрибут XML. |
|
Открытое поле, свойство, параметр или возвращаемое значение. |
Член может быть однозначно определен перечислением. |
|
Открытое поле, свойство, параметр или возвращаемое значение. |
Поле или свойство сериализуется как элемент XML. |
|
Открытое поле, идентификатор перечисления. |
Имя элемента члена перечисления. |
|
Открытые свойства и поля. |
При сериализации содержащего класса свойство или поле должно игнорироваться. |
|
Объявления открытых производных классов и возвращаемые значения открытых методов для документов WSDL. |
При создании схем класс должен быть включен (чтобы его можно было распознать во время сериализации). |
|
Объявления открытых классов. |
Управляет XML-сериализацией конечного объекта атрибута как корневого XML-элемента. Используйте атрибут, чтобы подробнее указать пространство имен и имя элемента. |
|
Открытые свойства и поля. |
Свойство или поле сериализуется как текст XML. |
|
Объявления открытых классов. |
Имя и пространство имен типа XML. |
Кроме этих атрибутов, которые располагаются в пространстве имен System.Xml.Serialization, к полю можно применять атрибут System.ComponentModel.DefaultValueAttribute. DefaultValueAttribute задает значение, которое автоматически назначается члену, если значение не указано.
Описание управления сериализацией кодированных элементов SOAP XML см. в разделе Атрибуты управления SOAP-сериализацией с кодировкой.
См. также
Задачи
Как указать имя альтернативного элемента для потока XML
Как сериализовать объект
Как десериализовать объект
Справочник
Основные понятия
Управление XML-сериализацией с использованием атрибутов