Поделиться через

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

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

Эти атрибуты также можно использовать для управления стилем «literal» сообщений 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 XML см. в разделе Атрибуты, которые управляют сериализацией в кодировке SOAP.

См. также