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


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

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

Классы

CodeExporter

Представляет класс, генерирующий код прокси-сервера из представления XML структуры данных.

CodeIdentifier

Предоставляет статические методы для преобразования входного текста в имена для сущностей кода.

CodeIdentifiers

Поддерживает группу имен для связанных сущностей кода или сопоставлений типов, сгенерированных инфраструктурой сериализации XML в .NET.

ImportContext

Описывает контекст, в котором набор схемы связан с сущностями кода .NET.

SchemaImporter

Описывает импортера схемы.

SoapAttributeAttribute

Указывает, что класс XmlSerializer должен сериализовать член класса как кодированный атрибут SOAP.

SoapAttributeOverrides

Позволяет переопределять атрибуты, примененные к свойствам, полям и классам, при использовании XmlSerializer для сериализации или десериализации объекта как кодированного элемента SOAP.

SoapAttributes

Представляет коллекцию объектов атрибута, контролирующих, как XmlSerializer сериализует и десериализует методы SOAP.

SoapCodeExporter

Генерирует объявления типов и атрибутов из информации внутреннего сопоставления типа для частей SOAP-кодированного сообщения, заданного в документе WSDL.

SoapElementAttribute

Указывает, что данный общий член будет сериализован посредством XmlSerializer как кодированный XML-элемент SOAP.

SoapEnumAttribute

Управляет тем, как XmlSerializer сериализует член перечисления.

SoapIgnoreAttribute

Инструктирует метод XmlSerializer не сериализовывать значение открытого поля или открытого свойства чтения/записи.

SoapIncludeAttribute

Позволяет XmlSerializer распознавать тип при сериализации или десериализации объекта согласно кодированию SOAP XML.

SoapReflectionImporter

Генерирует сопоставления с SOAP-кодированными сообщениями из типов .NET или сведений о методе веб-службы.

SoapSchemaExporter

Заполняет объекты XmlSchema определениями типов данных схемы XML для типов .NET Framework, сериализованных с использованием кодировки SOAP.

SoapSchemaImporter

Используется в рамках платформы .NET Framework для генерирования внутренних сопоставлений с типами платформы .NET Framework для частей SOAP-кодированных сообщений в документе WSDL.

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

Указывает, что член может быть определен с помощью перечисления.

XmlCodeExporter

Создает типы и объявления атрибутов из информации сопоставления внутреннего типа для объявлений элементов схемы XML.

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 класса.