System.Xml.Serialization Пространство имен
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Содержит классы, которые используются для сериализации объектов в XML-документы или потоки формата 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, сериализованных с помощью кодировки SOAP. |
| SoapSchemaImporter |
Используется в .NET Framework для создания внутренних сопоставлений с типами .NET для частей сообщений в кодировке SOAP в документе WSDL. |
| SoapSchemaMember |
Представляет определенные атрибуты элемента XSD < |
| SoapTypeAttribute |
Управляет схемой, созданной XmlSerializer при сериализации экземпляра класса в формате XML в кодировке SOAP. |
| 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 |
Представляет коллекцию объектов, используемых XmlElementAttributeXmlSerializer для переопределения способом сериализации класса по умолчанию. |
| 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 |
Содержит поля, которые можно использовать для передачи делегатов событий в потокобезопасный метод DeserializeXmlSerializer. |
Интерфейсы
| Имя | Описание |
|---|---|
| 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 для десериализации типов из закодированных в кодировке SOAP, не корневых XML-данных. |
| XmlSerializationWriteCallback |
Делегат, используемый классом XmlSerializer для сериализации типов из закодированных в кодировке SOAP, не корневых XML-данных. |
Комментарии
Центральным классом XmlSerializer в пространстве имен является класс. Чтобы использовать этот класс, используйте XmlSerializer конструктор для создания экземпляра класса, используя тип объекта для сериализации. XmlSerializer После создания создайте экземпляр объекта для сериализации. Необходимо также создать объект для записи файла в документ или поток, например StreamTextWriter, или XmlWriter. Затем можно вызвать Serialize метод для преобразования объекта в XML-документ.
Чтобы десериализировать объект из XML-документа, создайте подходящий объект для чтения документа или потока (опять же, а StreamTextWriterтакже ).XmlWriter Deserialize Вызовите метод при приведение результирующего объекта к типу исходного объекта (который был сериализован).
Для дальнейшего управления сериализацией System.Xml.Serialization пространство имен содержит несколько Attribute классов, которые можно применить к членам класса. Например, если класс содержит элемент, который будет сериализован как XML-элемент, можно применить XmlElementAttribute атрибут к члену. При применении атрибута можно указать такие сведения, как фактическое имя XML-элемента с помощью ElementName свойства. Полный список всех атрибутов см. в обзоре XmlSerializer класса.