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

Пространство имен System.Xml.Serialization содержит классы, используемые для сериализации объектов в документы или потоки формата XML. The System.Xml.Serialization namespace contains classes that are used to serialize objects into XML format documents or streams.

Классы

CodeExporter

Представляет класс, генерирующий код прокси-сервера из представления XML структуры данных.Represents a class that can generate proxy code from an XML representation of a data structure.

CodeIdentifier

Предоставляет статические методы для преобразования входного текста в имена для сущностей кода.Provides static methods to convert input text into names for code entities.

CodeIdentifiers

Поддерживает группу имен для связанных сущностей кода или сопоставлений типов, сгенерированных инфраструктурой сериализации XML платформы .NET Framework.Maintains a group of names for related code entities or type mappings that are generated by the .NET Framework's XML serialization infrastructure.

ImportContext

Описывает контекст, в котором набор схемы связан с кодовыми сущностями .NET Framework.Describes the context in which a set of schema is bound to .NET Framework code entities.

SchemaImporter

Описывает импортера схемы.Describes a schema importer.

SoapAttributeAttribute

Указывает, что класс XmlSerializer должен сериализовать член класса как кодированный атрибут SOAP.Specifies that the XmlSerializer must serialize the class member as an encoded SOAP attribute.

SoapAttributeOverrides

Позволяет переопределять атрибуты, примененные к свойствам, полям и классам, при использовании XmlSerializer для сериализации или десериализации объекта как кодированного элемента SOAP.Allows you to override attributes applied to properties, fields, and classes when you use an XmlSerializer to serialize or deserialize an object as encoded SOAP.

SoapAttributes

Представляет коллекцию объектов атрибута, контролирующих, как XmlSerializer сериализует и десериализует методы SOAP.Represents a collection of attribute objects that control how the XmlSerializer serializes and deserializes SOAP methods.

SoapCodeExporter

Генерирует объявления типов и атрибутов из информации внутреннего сопоставления типа для частей SOAP-кодированного сообщения, заданного в документе WSDL.Generates types and attribute declarations from internal type mapping information for SOAP-encoded message parts defined in a WSDL document.

SoapElementAttribute

Указывает, что данный общий член будет сериализован посредством XmlSerializer как кодированный XML-элемент SOAP.Specifies that the public member value be serialized by the XmlSerializer as an encoded SOAP XML element.

SoapEnumAttribute

Управляет тем, как XmlSerializer сериализует член перечисления.Controls how the XmlSerializer serializes an enumeration member.

SoapIgnoreAttribute

Инструктирует метод XmlSerializer не сериализовывать значение открытого поля или открытого свойства чтения/записи.Instructs the XmlSerializer not to serialize the public field or public read/write property value.

SoapIncludeAttribute

Позволяет XmlSerializer распознавать тип при сериализации или десериализации объекта согласно кодированию SOAP XML.Allows the XmlSerializer to recognize a type when it serializes or deserializes an object as encoded SOAP XML.

SoapReflectionImporter

Генерирует сопоставления с SOAP-кодированными сообщениями из типов .NET Framework или информации метода веб-службы.Generates mappings to SOAP-encoded messages from .NET Framework types or Web service method information.

SoapSchemaExporter

Заполняет объекты XmlSchema определениями типов данных схемы XML для типов .NET Framework, сериализованных с использованием кодировки SOAP.Populates XmlSchema objects with XML Schema data type definitions for .NET Framework types that are serialized using SOAP encoding.

SoapSchemaImporter

Используется в рамках платформы .NET Framework для генерирования внутренних сопоставлений с типами платформы .NET Framework для частей SOAP-кодированных сообщений в документе WSDL.Used within the .NET Framework to generate internal mappings to .NET Framework types for SOAP-encoded message parts in a WSDL document.

SoapSchemaMember

Представляет некоторые атрибуты элемента XSD <part> в документе WSDL для создания классов на основе этого документа.Represents certain attributes of a XSD <part> element in a WSDL document for generating classes from the document.

SoapTypeAttribute

Управляет схемой, сгенерированной XmlSerializer при сериализации экземпляра класса в качестве SOAP-кодированного XML.Controls the schema generated by the XmlSerializer when a class instance is serialized as SOAP encoded XML.

UnreferencedObjectEventArgs

Предоставляет данные для известного, но не неиспользованного объекта, обнаруженного в кодированном SOAP потоке XML во время десериализации.Provides data for the known, but unreferenced, object found in an encoded SOAP XML stream during deserialization.

XmlAnyAttributeAttribute

Указывает, что член (поле, возвращающее массив объектов XmlAttribute) может содержать любые атрибуты XML.Specifies that the member (a field that returns an array of XmlAttribute objects) can contain any XML attributes.

XmlAnyElementAttribute

Указывает, что член (поле, возвращающее массив объектов XmlElement или XmlNode) содержит объекты, представляющие любые элементы XML, не имеющие соответствующего члена в сериализуемом или десериализуемом объекте.Specifies that the member (a field that returns an array of XmlElement or XmlNode objects) contains objects that represent any XML element that has no corresponding member in the object being serialized or deserialized.

XmlAnyElementAttributes

Представляет коллекцию объектов XmlAnyElementAttribute.Represents a collection of XmlAnyElementAttribute objects.

XmlArrayAttribute

Указывает, что XmlSerializer необходимо выполнить сериализацию конкретного члена класса в качестве массива XML-элементов.Specifies that the XmlSerializer must serialize a particular class member as an array of XML elements.

XmlArrayItemAttribute

Представляет атрибут, который определяет производные типы, которые могут быть размещены XmlSerializer в сериализованном массиве.Represents an attribute that specifies the derived types that the XmlSerializer can place in a serialized array.

XmlArrayItemAttributes

Представляет коллекцию объектов XmlArrayItemAttribute.Represents a collection of XmlArrayItemAttribute objects.

XmlAttributeAttribute

Указывает, что XmlSerializer необходимо выполнить сериализацию члена класса в качестве XML-атрибута.Specifies that the XmlSerializer must serialize the class member as an XML attribute.

XmlAttributeEventArgs

Предоставляет данные для события UnknownAttribute.Provides data for the UnknownAttribute event.

XmlAttributeOverrides

Позволяет переопределять атрибуты свойства, поля и класса при использовании XmlSerializer для сериализации или десериализации объекта.Allows you to override property, field, and class attributes when you use the XmlSerializer to serialize or deserialize an object.

XmlAttributes

Представление коллекции объектов атрибутов, управляющих сериализацией и десериализацией объекта с помощью XmlSerializer.Represents a collection of attribute objects that control how the XmlSerializer serializes and deserializes an object.

XmlChoiceIdentifierAttribute

Указывает, что член может быть обнаружен посредством перечисления.Specifies that the member can be further detected by using an enumeration.

XmlCodeExporter

Создает типы и объявления атрибутов из информации сопоставления внутреннего типа для объявлений элементов схемы XML.Generates types and attribute declarations from internal type mapping information for XML schema element declarations.

XmlElementAttribute

Указывает, что открытое поле или свойство представляет XML-элемент, когда XmlSerializer сериализует или десериализует объект, содержащий его.Indicates that a public field or property represents an XML element when the XmlSerializer serializes or deserializes the object that contains it.

XmlElementAttributes

Представляет коллекцию объектов XmlElementAttribute, используемую XmlSerializer для переопределения способа сериализации класса, используемого по умолчанию.Represents a collection of XmlElementAttribute objects used by the XmlSerializer to override the default way it serializes a class.

XmlElementEventArgs

Предоставляет данные для события UnknownElement.Provides data for the UnknownElement event.

XmlEnumAttribute

Управляет тем, как XmlSerializer сериализует член перечисления.Controls how the XmlSerializer serializes an enumeration member.

XmlIgnoreAttribute

Инструктирует метод Serialize(TextWriter, Object), принадлежащий XmlSerializer, не сериализовывать значение открытого поля или открытого свойства чтения/записи.Instructs the Serialize(TextWriter, Object) method of the XmlSerializer not to serialize the public field or public read/write property value.

XmlIncludeAttribute

Позволяет XmlSerializer распознавать тип в процессе сериализации или десериализации объекта.Allows the XmlSerializer to recognize a type when it serializes or deserializes an object.

XmlMapping

Поддерживает сопоставление типов платформе .NET Framework и типов данных схемы XML.Supports mappings between .NET Framework types and XML Schema data types.

XmlMemberMapping

Сопоставляет сущность кода в методе веб-службы .NET Framework с элементом в сообщении языка описания веб-служб (WSDL).Maps a code entity in a .NET Framework Web service method to an element in a Web Services Description Language (WSDL) message.

XmlMembersMapping

Предоставляет сопоставления методов веб-служб .NET Framework и сообщений языка описания веб-служб (WSDL), заданных для веб-служб SOAP.Provides mappings between .NET Framework Web service methods and Web Services Description Language (WSDL) messages that are defined for SOAP Web services.

XmlNamespaceDeclarationsAttribute

Указывает, что целевое свойство, параметр, возвращаемое значение или член класса содержит префиксы, связанные с пространствами имен, используемыми в документе XML.Specifies that the target property, parameter, return value, or class member contains prefixes associated with namespaces that are used within an XML document.

XmlNodeEventArgs

Предоставляет данные для события UnknownNode.Provides data for the UnknownNode event.

XmlReflectionImporter

Генерирует сопоставления с объявлениями элемента схемы XML, включая литерал частей сообщения определения схемы XML (XSD) в документе языка описания веб-служб (WSDL), для типов платформе .NET Framework или информации метода веб-службы.Generates mappings to XML schema element declarations, including literal XML Schema Definition (XSD) message parts in a Web Services Description Language (WSDL) document, for .NET Framework types or Web service method information.

XmlReflectionMember

Обеспечивает сопоставление между объектами кода в методах веб-служб .NET Framework и содержимым сообщений WSDL, определенных для веб-служб SOAP.Provides mappings between code entities in .NET Framework Web service methods and the content of Web Services Description Language (WSDL) messages that are defined for SOAP Web services.

XmlRootAttribute

Управляет XML-сериализацией конечного объекта атрибута как корневого XML-элемента.Controls XML serialization of the attribute target as an XML root element.

XmlSchemaEnumerator

Обеспечивает итерацию над коллекцией объектов XmlSchema.Enables iteration over a collection of XmlSchema objects.

XmlSchemaExporter

Заполняет объекты XmlSchema объявлениями элементов схемы XML, обнаруженными в объектах сопоставления типов.Populates XmlSchema objects with XML schema element declarations that are found in type mapping objects.

XmlSchemaImporter

Создает внутренние сопоставления типам .NET Framework для объявлений элементов XML-схемы, включая части литеральных XSD-сообщений в документе WSDL.Generates internal mappings to .NET Framework types for XML schema element declarations, including literal XSD message parts in a WSDL document.

XmlSchemaProviderAttribute

При применении к типу хранит имя статического метода типа, возвращающего XML-схему и объект XmlQualifiedName (или XmlSchemaType для анонимных типов), который управляет сериализацией этого типа.When applied to a type, stores the name of a static method of the type that returns an XML schema and a XmlQualifiedName (or XmlSchemaType for anonymous types) that controls the serialization of the type.

XmlSchemas

Представляет коллекцию XML-схем.Represents the collection of XML schemas.

XmlSerializationGeneratedCode

Абстрактный класс, который является базовым классом для XmlSerializationReader и XmlSerializationWriter, содержит методы, общие для обоих этих типов.An abstract class that is the base class for XmlSerializationReader and XmlSerializationWriter and that contains methods common to both of these types.

XmlSerializationReader

Управляет десериализацией с помощью класса XmlSerializer.Controls deserialization by the XmlSerializer class.

XmlSerializationReader.CollectionFixup

Содержит экземпляр делегата XmlSerializationCollectionFixupCallback и входные данные метода, а также предоставляет параметры методаHolds an XmlSerializationCollectionFixupCallback delegate instance, plus the method's inputs; also supplies the method's parameters.

XmlSerializationReader.Fixup

Вмещает XmlSerializationFixupCallback экземпляр делегата, а также входные данные метода; кроме того, служит параметром метода.Holds an XmlSerializationFixupCallback delegate instance, plus the method's inputs; also serves as the parameter for the method.

XmlSerializationWriter

Представляет абстрактный класс, используемый для управления сериализацией классом XmlSerializer.Represents an abstract class used for controlling serialization by the XmlSerializer class.

XmlSerializer

Сериализует и десериализует объекты в XML-документы и из них.Serializes and deserializes objects into and from XML documents. XmlSerializer позволяет контролировать способ кодирования объектов в XML.The XmlSerializer enables you to control how objects are encoded into XML.

XmlSerializerAssemblyAttribute

При применении к клиентскому прокси веб-службы позволяет указать сборку, содержащую пользовательские сериализаторы.Applied to a Web service client proxy, enables you to specify an assembly that contains custom-made serializers.

XmlSerializerFactory

Создает версии с определенными типами XmlSerializer для более эффективной сериализации.Creates typed versions of the XmlSerializer for more efficient serialization.

XmlSerializerImplementation

Определяет считывающий, записывающий элемент и методы для предварительно сгенерированных сериализаторов с определенным типом.Defines the reader, writer, and methods for pre-generated, typed serializers.

XmlSerializerNamespaces

Содержит пространства имен XML и префиксы, используемые XmlSerializer для генерирования полных имен в экземпляре документа XML.Contains the XML namespaces and prefixes that the XmlSerializer uses to generate qualified names in an XML-document instance.

XmlSerializerVersionAttribute

Отмечает, что код был сгенерирован инфраструктурой сериализации, а также что код может быть повторно использован для повышения производительности при применении данного атрибута к сборке.Signifies that the code was generated by the serialization infrastructure and can be reused for increased performance, when this attribute is applied to an assembly.

XmlTextAttribute

Указывает на XmlSerializer, что член должен обрабатываться как текст XML, когда содержащий его класс сериализуется или десериализуется.Indicates to the XmlSerializer that the member must be treated as XML text when the class that contains it is serialized or deserialized.

XmlTypeAttribute

Управляет схемой XML, которая создается при сериализации конечного объекта атрибута классом XmlSerializer.Controls the XML schema that is generated when the attribute target is serialized by the XmlSerializer.

XmlTypeMapping

Содержит сопоставление одного типа с другим.Contains a mapping of one type to another.

Структуры

XmlDeserializationEvents

Содержит поля, которые могут быть использованы для передачи делегатов событий в потокобезопасный метод Deserialize из XmlSerializer.Contains fields that can be used to pass event delegates to a thread-safe Deserialize method of the XmlSerializer.

Интерфейсы

IXmlSerializable

Предоставляет пользовательский формат для сериализации и десериализации XML.Provides custom formatting for XML serialization and deserialization.

IXmlTextParser

Задает свойство Normalized для использования в инфраструктуре платформы .NET Framework.Establishes a Normalized property for use by the .NET Framework infrastructure.

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

CodeGenerationOptions

Определяет различные параметры, которые применяются при создании типов .NET, используемых с веб-службой XML.Specifies various options to use when generating .NET types for use with an XML Web Service.

XmlMappingAccess

Указывает на чтение, запись или на оба процесса для сопоставления.Specifies whether a mapping is read, write, or both.

Делегаты

UnreferencedObjectEventHandler

Представляет метод, обрабатывающий событие UnreferencedObject класса XmlSerializer.Represents the method that handles the UnreferencedObject event of an XmlSerializer.

XmlAttributeEventHandler

Представляет метод, обрабатывающий UnknownAttributeRepresents the method that handles the UnknownAttribute

XmlElementEventHandler

Представляет метод, обрабатывающий событие UnknownElement класса XmlSerializer.Represents the method that handles the UnknownElement event of an XmlSerializer.

XmlNodeEventHandler

Представляет метод, обрабатывающий событие UnknownNode класса XmlSerializer.Represents the method that handles the UnknownNode event of an XmlSerializer.

XmlSerializationCollectionFixupCallback

Делегат, используемый классом XmlSerializer для десериализации типов данных XML с кодированием SOAP, которые сопоставлены коллекциям перечислений.Delegate used by the XmlSerializer class for deserialization of SOAP-encoded XML data types that map to collections or enumerations.

XmlSerializationFixupCallback

Делегат, используемый классом XmlSerializer для десериализации XML-данных с кодировкой SOAP.Delegate used by the XmlSerializer class for deserialization of SOAP-encoded XML data.

XmlSerializationReadCallback

Делегат, используемый классом XmlSerializer для десериализации типов из некорневых данных XML с кодировкой SOAP.Delegate used by the XmlSerializer class for deserialization of types from SOAP-encoded, non-root XML data.

XmlSerializationWriteCallback

Делегат, используемый классом XmlSerializer, для сериализации типов из SOAP-кодированных некорневых данных XML.Delegate that is used by the XmlSerializer class for serialization of types from SOAP-encoded, non-root XML data.

Комментарии

Центральным классом в пространстве имен является XmlSerializer класса.The central class in the namespace is the XmlSerializer class. Чтобы использовать этот класс, используйте XmlSerializer конструктор для создания экземпляра класса, используя тип объекта для сериализации.To use this class, use the XmlSerializer constructor to create an instance of the class using the type of the object to serialize. Один раз XmlSerializer будет создан, создайте экземпляр объекта для сериализации.Once an XmlSerializer is created, create an instance of the object to serialize. Необходимо также создать объект для записи файла в документ или поток, такие как Stream, TextWriter, или XmlWriter.You must also create an object to write the file to a document or stream, such as a Stream, TextWriter, or XmlWriter. Затем можно вызвать Serialize метода для преобразования объекта в XML-документа.You can then call the Serialize method to convert the object into an XML document.

Для десериализации объекта из XML-документа, необходимо создать соответствующий объект для чтения документа или потока (опять же, Stream, TextWriter, или XmlWriter).To deserialize an object from an XML document, create a suitable object to read the document or stream (again, a Stream, TextWriter, or XmlWriter). Вызвать Deserialize метода во время приведения полученного объекта к типу исходного объекта (который был сериализован).Invoke the Deserialize method while casting the resulting object to the type of the original object (that was serialized).

Для дальнейшего управления сериализацией, System.Xml.Serialization пространство имен содержит несколько Attribute классы, которые могут применяться к членам класса.To further control the serialization, the System.Xml.Serialization namespace contains several Attribute classes that can be applied to members of a class. Например, если класс содержит элемент, который будет сериализован в виде XML-элемента, можно применить XmlElementAttribute атрибут.For example, if a class contains a member that will be serialized as an XML element, you can apply the XmlElementAttribute attribute to the member. При применении атрибута, можно указать сведения, такие как фактические XML-элемент имя с помощью ElementName свойство.When applying the attribute, you can specify details such as the actual XML element name using the ElementName property. Полный список всех атрибутов, см. в разделе XmlSerializer Общие сведения о классе.For a complete list of all the attributes, see the XmlSerializer class overview.