System.Xml.Serialization Пространство имен

Содержит классы, используемые для сериализации объектов в документы формата XML или в потоки.

Классы

CodeIdentifier	Предоставляет статические методы для преобразования входного текста в имена для сущностей кода.
CodeIdentifiers	Поддерживает группу имен для связанных сущностей кода или сопоставлений типов, сгенерированных инфраструктурой сериализации XML в .NET.
ImportContext	Описывает контекст, в котором набор схемы связан с сущностями кода .NET.
SchemaImporter	Описывает импортера схемы.
SoapAttributeAttribute	Указывает, что класс XmlSerializer должен сериализовать член класса как кодированный атрибут SOAP.
SoapAttributeOverrides	Позволяет переопределять атрибуты, примененные к свойствам, полям и классам, при использовании XmlSerializer для сериализации или десериализации объекта как кодированного элемента SOAP.
SoapAttributes	Представляет коллекцию объектов атрибута, контролирующих, как XmlSerializer сериализует и десериализует методы SOAP.
SoapElementAttribute	Указывает, что данный общий член будет сериализован посредством XmlSerializer как кодированный XML-элемент SOAP.
SoapEnumAttribute	Управляет тем, как XmlSerializer сериализует член перечисления.
SoapIgnoreAttribute	Инструктирует метод XmlSerializer не сериализовывать значение открытого поля или открытого свойства чтения/записи.
SoapIncludeAttribute	Позволяет XmlSerializer распознавать тип при сериализации или десериализации объекта согласно кодированию SOAP XML.
SoapReflectionImporter	Генерирует сопоставления с SOAP-кодированными сообщениями из типов .NET или сведений о методе веб-службы.
SoapSchemaMember	Представляет некоторые атрибуты элемента XSD <part> в документе WSDL для создания классов на основе этого документа.
SoapTypeAttribute	Управляет схемой, сгенерированной XmlSerializer при сериализации экземпляра класса в качестве SOAP-кодированного XML.
UnreferencedObjectEventArgs	Предоставляет данные для известного, но не неиспользованного объекта, обнаруженного в кодированном SOAP потоке XML во время десериализации.
XmlAnyAttributeAttribute	Указывает, что член (поле, возвращающее массив объектов XmlAttribute) может содержать любые атрибуты XML.
XmlAnyElementAttribute	Указывает, что член (поле, возвращающее массив объектов XmlElement или XmlNode) содержит объекты, представляющие любые элементы XML, не имеющие соответствующего члена в сериализуемом или десериализуемом объекте.
XmlAnyElementAttributes	Представляет коллекцию объектов XmlAnyElementAttribute.
XmlArrayAttribute	Указывает, что XmlSerializer необходимо выполнить сериализацию конкретного члена класса в качестве массива XML-элементов.
XmlArrayItemAttribute	Представляет атрибут, который определяет производные типы, которые могут быть размещены XmlSerializer в сериализованном массиве.
XmlArrayItemAttributes	Представляет коллекцию объектов XmlArrayItemAttribute.
XmlAttributeAttribute	Указывает, что XmlSerializer необходимо выполнить сериализацию члена класса в качестве XML-атрибута.
XmlAttributeEventArgs	Предоставляет данные для события UnknownAttribute.
XmlAttributeOverrides	Позволяет переопределять атрибуты свойства, поля и класса при использовании XmlSerializer для сериализации или десериализации объекта.
XmlAttributes	Представление коллекции объектов атрибутов, управляющих сериализацией и десериализацией объекта с помощью XmlSerializer.
XmlChoiceIdentifierAttribute	Указывает, что член может быть определен с помощью перечисления.
XmlElementAttribute	Указывает, что открытое поле или свойство представляет XML-элемент, когда XmlSerializer сериализует или десериализует объект, содержащий его.
XmlElementAttributes	Представляет коллекцию объектов XmlElementAttribute, используемых классом XmlSerializer для переопределения стандартного способа сериализации класса.
XmlElementEventArgs	Предоставляет данные для события UnknownElement.
XmlEnumAttribute	Управляет тем, как XmlSerializer сериализует член перечисления.
XmlIgnoreAttribute	Инструктирует метод Serialize(TextWriter, Object), принадлежащий XmlSerializer, не сериализовывать значение открытого поля или открытого свойства чтения/записи.
XmlIncludeAttribute	Позволяет XmlSerializer распознавать тип в процессе сериализации или десериализации объекта.
XmlMapping	Поддерживает сопоставление типов .NET и типов данных схемы XML.
XmlMemberMapping	Сопоставляет сущность кода в методе веб-службы .NET с элементом в сообщении языка описания веб-служб (WSDL).
XmlMembersMapping	Предоставляет сопоставления методов веб-служб .NET и сообщений языка описания веб-служб (WSDL), заданных для веб-служб SOAP.
XmlNamespaceDeclarationsAttribute	Указывает, что целевое свойство, параметр, возвращаемое значение или член класса содержат префиксы, связанные с пространствами имен, которые используются в XML-документе.
XmlNodeEventArgs	Предоставляет данные для события UnknownNode.
XmlReflectionImporter	Генерирует сопоставления с объявлениями элементов схемы XML, включая литерал частей сообщения определения схемы XML (XSD) в документе языка описания веб-служб (WSDL), для типов .NET или сведений о методе веб-службы.
XmlReflectionMember	Обеспечивает сопоставление между сущностями кода в методах веб-служб .NET и содержимым сообщений WSDL, определенных для веб-служб SOAP.
XmlRootAttribute	Управляет XML-сериализацией конечного объекта атрибута как корневого XML-элемента.
XmlSchemaEnumerator	Позволяет выполнение итерации по коллекции объектов XmlSchema.
XmlSchemaExporter	Заполняет объекты XmlSchema объявлениями элементов схемы XML, обнаруженными в объектах сопоставления типов.
XmlSchemaImporter	Создает внутренние сопоставления типам .NET для объявлений элементов схемы XML, включая части литеральных XSD-сообщений в документе WSDL.
XmlSchemaProviderAttribute	При применении к типу хранит имя статического метода типа, возвращающего XML-схему и объект XmlQualifiedName (или XmlSchemaType для анонимных типов), который управляет сериализацией этого типа.
XmlSchemas	Представляет коллекцию схем XML.
XmlSerializationGeneratedCode	Абстрактный класс, который является базовым классом для XmlSerializationReader и XmlSerializationWriter, содержит методы, общие для обоих этих типов.
XmlSerializationReader	Управляет десериализацией с помощью класса XmlSerializer.
XmlSerializationReader.CollectionFixup	Содержит экземпляр делегата XmlSerializationCollectionFixupCallback и входные данные метода, а также предоставляет параметры метода
XmlSerializationReader.Fixup	Вмещает XmlSerializationFixupCallback экземпляр делегата, а также входные данные метода; кроме того, служит параметром метода.
XmlSerializationWriter	Представляет абстрактный класс, используемый для управления сериализацией классом XmlSerializer.
XmlSerializer	Сериализует и десериализует объекты в XML-документы и из них. XmlSerializer позволяет контролировать способ кодирования объектов в XML.
XmlSerializerAssemblyAttribute	При применении к клиентскому прокси веб-службы позволяет указать сборку, содержащую пользовательские сериализаторы.
XmlSerializerFactory	Создает версии с определенными типами XmlSerializer для более эффективной сериализации.
XmlSerializerImplementation	Определяет считывающий, записывающий элемент и методы для предварительно сгенерированных сериализаторов с определенным типом.
XmlSerializerNamespaces	Содержит пространства имен XML и префиксы, используемые XmlSerializer для генерирования полных имен в экземпляре документа XML.
XmlSerializerVersionAttribute	Отмечает, что код был сгенерирован инфраструктурой сериализации, а также что код может быть повторно использован для повышения производительности при применении данного атрибута к сборке.
XmlTextAttribute	Указывает на XmlSerializer, что член должен обрабатываться как текст XML, когда содержащий его класс сериализуется или десериализуется.
XmlTypeAttribute	Управляет схемой XML, которая создается при сериализации конечного объекта атрибута классом XmlSerializer.
XmlTypeMapping	Содержит сопоставление одного типа с другим.

Структуры

XmlDeserializationEvents

Содержит поля, которые могут быть использованы для передачи делегатов событий в потокобезопасный метод Deserialize из XmlSerializer.

Интерфейсы

IXmlSerializable	Предоставляет пользовательский формат для сериализации и десериализации XML.
IXmlTextParser	Задает свойство Normalized для использования в инфраструктуре .NET.

Перечисления

CodeGenerationOptions	Определяет различные параметры, которые применяются при создании типов .NET, используемых с веб-службой XML.
XmlMappingAccess	Указывает на чтение, запись или на оба процесса для сопоставления.

Делегаты

UnreferencedObjectEventHandler	Представляет метод, обрабатывающий событие UnreferencedObject класса XmlSerializer.
XmlAttributeEventHandler	Представляет метод, обрабатывающий событие UnknownAttribute.
XmlElementEventHandler	Представляет метод, обрабатывающий событие UnknownElement класса XmlSerializer.
XmlNodeEventHandler	Представляет метод, обрабатывающий событие UnknownNode класса XmlSerializer.
XmlSerializationCollectionFixupCallback	Делегат, используемый классом XmlSerializer для десериализации типов данных XML с кодированием SOAP, которые сопоставлены коллекциям перечислений.
XmlSerializationFixupCallback	Делегат, используемый классом XmlSerializer для десериализации XML-данных с кодировкой SOAP.
XmlSerializationReadCallback	Делегат, используемый классом XmlSerializer для десериализации типов из некорневых данных XML с кодировкой SOAP.
XmlSerializationWriteCallback	Делегат, используемый классом XmlSerializer, для сериализации типов из SOAP-кодированных некорневых данных XML.

Комментарии

Центральным классом в пространстве имен является XmlSerializer класс . Чтобы использовать этот класс, используйте XmlSerializer конструктор для создания экземпляра класса , используя тип объекта для сериализации. XmlSerializer После создания создайте экземпляр объекта для сериализации. Необходимо также создать объект для записи файла в документ или поток, например Stream, TextWriterили XmlWriter. Затем можно вызвать Serialize метод для преобразования объекта в XML-документ.

Чтобы десериализовать объект из XML-документа, создайте подходящий объект для чтения документа или потока (опять же, Stream, TextWriterили XmlWriter). Вызовите Deserialize метод при приведение результирующего объекта к типу исходного объекта (который был сериализован).

Для дальнейшего управления сериализацией System.Xml.Serialization пространство имен содержит несколько Attribute классов, которые можно применить к членам класса. Например, если класс содержит элемент, который будет сериализован как XML-элемент, можно применить XmlElementAttribute атрибут к члену. При применении атрибута можно указать такие сведения, как фактическое имя ЭЛЕМЕНТА XML, с помощью ElementName свойства . Полный список всех атрибутов см. в обзоре XmlSerializer класса.