System.Xml.Serialization Namespace

El espacio de nombres System.Xml.Serialization contiene clases que se utilizan para serializar objetos en secuencias o documentos con formato XML. The System.Xml.Serialization namespace contains classes that are used to serialize objects into XML format documents or streams.

Clases

CodeExporter

Representa una clase que puede generar el código proxy de una representación XML de una estructura de datos.Represents a class that can generate proxy code from an XML representation of a data structure.

CodeIdentifier

Proporciona métodos estáticos para convertir el texto de entrada en nombres para las entidades de código.Provides static methods to convert input text into names for code entities.

CodeIdentifiers

Mantiene un grupo de nombres para entidades de código o asignaciones de tipo que son generadas por la infraestructura de serialización XML de .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

Describe el contexto en el que un conjunto de esquema se enlaza a las entidades de código de .NET Framework.Describes the context in which a set of schema is bound to .NET Framework code entities.

SchemaImporter

Describe un importador de esquemas.Describes a schema importer.

SoapAttributeAttribute

Especifica que XmlSerializer debe serializar el miembro de clase como un atributo SOAP codificado.Specifies that the XmlSerializer must serialize the class member as an encoded SOAP attribute.

SoapAttributeOverrides

Permite reemplazar atributos aplicados a propiedades, campos y clases cuando se utiliza un objeto XmlSerializer para serializar o deserializar un objeto como SOAP codificado.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

Representa a una colección de objetos de atributos que controlan el modo en que XmlSerializer serializa y deserializa los métodos SOAP.Represents a collection of attribute objects that control how the XmlSerializer serializes and deserializes SOAP methods.

SoapCodeExporter

Genera tipos y declaraciones de atributos a partir de información de asignación de tipos interna para partes del mensaje con codificación SOAP y definidas en un documento WSDL.Generates types and attribute declarations from internal type mapping information for SOAP-encoded message parts defined in a WSDL document.

SoapElementAttribute

Especifica que XmlSerializer debe serializar el valor del miembro público como un elemento XML SOAP codificado.Specifies that the public member value be serialized by the XmlSerializer as an encoded SOAP XML element.

SoapEnumAttribute

Controla el modo en que XmlSerializer serializa un miembro de enumeración.Controls how the XmlSerializer serializes an enumeration member.

SoapIgnoreAttribute

Instruye al XmlSerializer para que no serialice el valor de campo público o propiedad pública de lectura/escritura.Instructs the XmlSerializer not to serialize the public field or public read/write property value.

SoapIncludeAttribute

Permite que XmlSerializer reconozca un tipo al serializar o deserializar un objeto como XML SOAP codificado.Allows the XmlSerializer to recognize a type when it serializes or deserializes an object as encoded SOAP XML.

SoapReflectionImporter

Genera asignaciones a los mensajes con codificación SOAP desde los tipos de .NET Framework o la información de métodos del servicio Web.Generates mappings to SOAP-encoded messages from .NET Framework types or Web service method information.

SoapSchemaExporter

Rellena los objetos XmlSchema con definiciones de tipo de datos de esquemas XML para tipos de .NET Framework que se serializan utilizando la codificación SOAP.Populates XmlSchema objects with XML Schema data type definitions for .NET Framework types that are serialized using SOAP encoding.

SoapSchemaImporter

Se utiliza dentro de .NET Framework para generar asignaciones internas a los tipos de .NET Framework para las partes del mensaje codificadas con SOAP en un documento WSDL.Used within the .NET Framework to generate internal mappings to .NET Framework types for SOAP-encoded message parts in a WSDL document.

SoapSchemaMember

Representa ciertos atributos de un elemento <part> XSD elemento en un documento WSDL para generar clases a partir del documento.Represents certain attributes of a XSD <part> element in a WSDL document for generating classes from the document.

SoapTypeAttribute

Controla el esquema generado por XmlSerializer cuando se serializa una instancia de clase como XML SOAP codificado.Controls the schema generated by the XmlSerializer when a class instance is serialized as SOAP encoded XML.

UnreferencedObjectEventArgs

Proporciona datos del objeto conocido, pero sin referencia, detectado en una secuencia XML SOAP codificada durante la deserialización.Provides data for the known, but unreferenced, object found in an encoded SOAP XML stream during deserialization.

XmlAnyAttributeAttribute

Especifica que el miembro (un campo que devuelve una matriz de objetos XmlAttribute) puede contener cualquier atributo XML.Specifies that the member (a field that returns an array of XmlAttribute objects) can contain any XML attributes.

XmlAnyElementAttribute

Especifica que el miembro (un campo que devuelve una matriz de objetos XmlElement o XmlNode) contiene objetos que representan los elementos XLM que no tienen un miembro correspondiente en el objeto que se está serializando o deserializando.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

Representa una colección de objetos XmlAnyElementAttribute.Represents a collection of XmlAnyElementAttribute objects.

XmlArrayAttribute

Especifica que XmlSerializer debe serializar un miembro de clase determinado como matriz de elementos XML.Specifies that the XmlSerializer must serialize a particular class member as an array of XML elements.

XmlArrayItemAttribute

Representa un atributo que especifica los tipos derivados que XmlSerializer puede colocar en una matriz serializada.Represents an attribute that specifies the derived types that the XmlSerializer can place in a serialized array.

XmlArrayItemAttributes

Representa una colección de objetos XmlArrayItemAttribute.Represents a collection of XmlArrayItemAttribute objects.

XmlAttributeAttribute

Especifica que XmlSerializer debe serializar el miembro de la clase como un atributo XML.Specifies that the XmlSerializer must serialize the class member as an XML attribute.

XmlAttributeEventArgs

Proporciona datos para el evento UnknownAttribute.Provides data for the UnknownAttribute event.

XmlAttributeOverrides

Permite reemplazar los atributos de las propiedades, campos y clases al utilizar XmlSerializer para serializar o deserializar un objeto.Allows you to override property, field, and class attributes when you use the XmlSerializer to serialize or deserialize an object.

XmlAttributes

Representa una colección de objetos de atributo que controlan el modo en que XmlSerializer serializa y deserializa un objeto.Represents a collection of attribute objects that control how the XmlSerializer serializes and deserializes an object.

XmlChoiceIdentifierAttribute

Especifica que el miembro se puede detectar mejor utilizando una enumeración.Specifies that the member can be further detected by using an enumeration.

XmlCodeExporter

Genera tipos y declaraciones de atributos de información de asignación de tipos interna para las declaraciones del elemento de esquema XML.Generates types and attribute declarations from internal type mapping information for XML schema element declarations.

XmlElementAttribute

Indica que un campo público o una propiedad pública representa un elemento XML, cuando XmlSerializer serializa o deserializa el objeto que lo contiene.Indicates that a public field or property represents an XML element when the XmlSerializer serializes or deserializes the object that contains it.

XmlElementAttributes

Representa una colección de objetos XmlElementAttribute, que XmlSerializer utiliza para reemplazar la forma predeterminada en que serializa una clase.Represents a collection of XmlElementAttribute objects used by the XmlSerializer to override the default way it serializes a class.

XmlElementEventArgs

Proporciona datos para el evento UnknownElement.Provides data for the UnknownElement event.

XmlEnumAttribute

Controla el modo en que XmlSerializer serializa un miembro de enumeración.Controls how the XmlSerializer serializes an enumeration member.

XmlIgnoreAttribute

Instruye al método Serialize(TextWriter, Object) de XmlSerializer para que no serialice el valor de campo público o propiedad pública de lectura/escritura.Instructs the Serialize(TextWriter, Object) method of the XmlSerializer not to serialize the public field or public read/write property value.

XmlIncludeAttribute

Permite que XmlSerializer reconozca un tipo al serializar o deserializar un objeto.Allows the XmlSerializer to recognize a type when it serializes or deserializes an object.

XmlMapping

Admite asignaciones entre tipos de .NET Framework y tipos de datos de esquemas XML.Supports mappings between .NET Framework types and XML Schema data types.

XmlMemberMapping

Asigna una entidad de código de un método del servicio Web de .NET Framework a un elemento de un mensaje escrito en Lenguaje de descripción de servicios Web (WSDL).Maps a code entity in a .NET Framework Web service method to an element in a Web Services Description Language (WSDL) message.

XmlMembersMapping

Proporciona asignaciones entre los métodos del servicio Web de .NET Framework y los mensajes del lenguaje de descripción de servicios Web (WSDL) que se definen para los servicios Web de SOAP.Provides mappings between .NET Framework Web service methods and Web Services Description Language (WSDL) messages that are defined for SOAP Web services.

XmlNamespaceDeclarationsAttribute

Especifica que la propiedad, parámetro, valor devuelto o miembro de clase de destino contiene prefijos asociados a espacios de nombres que se utilizan en un documento 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

Proporciona datos para el evento UnknownNode.Provides data for the UnknownNode event.

XmlReflectionImporter

Genera asignaciones a declaraciones de elementos de esquema XML, incluidas las partes de mensaje literales de definición de esquemas XML (XSD) de un documento escrito en lenguaje de descripción de servicios Web (WSDL), para los tipos de .NET Framework o la información del método de servicio Web.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

Proporciona asignaciones entre las entidades de código de los métodos del servicio Web de .NET Framework y el contenido de los mensajes del lenguaje de descripción de servicios Web (WSDL) que se definen para los servicios Web de 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

Controla la serialización XML del destino de atributo como elemento raíz XML.Controls XML serialization of the attribute target as an XML root element.

XmlSchemaEnumerator

Habilita la iteración sobre una colección de objetos XmlSchema.Enables iteration over a collection of XmlSchema objects.

XmlSchemaExporter

Rellena los objetos XmlSchema con declaraciones del elemento de esquema XML que se encuentran en los objetos de asignación de tipo.Populates XmlSchema objects with XML schema element declarations that are found in type mapping objects.

XmlSchemaImporter

Genera las asignaciones internas a los tipos de .NET Framework para las declaraciones del elemento de esquema XML, incluidas las partes literales del mensaje XSD en un documento WSDL.Generates internal mappings to .NET Framework types for XML schema element declarations, including literal XSD message parts in a WSDL document.

XmlSchemaProviderAttribute

Cuando se aplica a un tipo, almacena el nombre de un método estático del tipo que devuelve un esquema XML y un XmlQualifiedName (o XmlSchemaType para los tipos anónimos) que controla la serialización del tipo.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

Representa la colección de esquemas XML.Represents the collection of XML schemas.

XmlSerializationGeneratedCode

Clase abstracta que es la clase base para XmlSerializationReader y XmlSerializationWriter y que contiene los métodos comunes a ambos tipos.An abstract class that is the base class for XmlSerializationReader and XmlSerializationWriter and that contains methods common to both of these types.

XmlSerializationReader

Controla la deserialización por la clase XmlSerializer.Controls deserialization by the XmlSerializer class.

XmlSerializationReader.CollectionFixup

Contiene una instancia de delegado XmlSerializationCollectionFixupCallback, más las entradas del método; también proporciona los parámetros del método.Holds an XmlSerializationCollectionFixupCallback delegate instance, plus the method's inputs; also supplies the method's parameters.

XmlSerializationReader.Fixup

Contiene una instancia del delegado XmlSerializationFixupCallback, además de las entradas del método; también actúa como parámetro del método.Holds an XmlSerializationFixupCallback delegate instance, plus the method's inputs; also serves as the parameter for the method.

XmlSerializationWriter

Representa una clase abstracta usada para controlar la serialización realizada por la clase XmlSerializer.Represents an abstract class used for controlling serialization by the XmlSerializer class.

XmlSerializer

Serializa y deserializa objetos en y desde documentos XML.Serializes and deserializes objects into and from XML documents. XmlSerializer permite controlar el modo en que se codifican los objetos en XML.The XmlSerializer enables you to control how objects are encoded into XML.

XmlSerializerAssemblyAttribute

Aplicado a un proxy cliente de servicios Web, le permite especificar un ensamblado que contiene los serializadores hechos a medida.Applied to a Web service client proxy, enables you to specify an assembly that contains custom-made serializers.

XmlSerializerFactory

Crea versiones con establecimiento de tipos de XmlSerializer para una serialización más eficaz.Creates typed versions of the XmlSerializer for more efficient serialization.

XmlSerializerImplementation

Define el lector, el escritor y los métodos para los serializadores con establecimiento de tipos generados previamente.Defines the reader, writer, and methods for pre-generated, typed serializers.

XmlSerializerNamespaces

Contiene los espacios de nombres XML y prefijos que XmlSerializer utiliza para generar nombres calificados en una instancia de documento XML.Contains the XML namespaces and prefixes that the XmlSerializer uses to generate qualified names in an XML-document instance.

XmlSerializerVersionAttribute

Significa que el código lo generó la infraestructura de serialización y se puede reutilizar para aumentar el rendimiento, cuando este atributo se aplica a un ensamblado.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

Indica a XmlSerializer que el miembro debe tratarse como texto XML cuando se serializa o se deserializa la clase contenedora.Indicates to the XmlSerializer that the member must be treated as XML text when the class that contains it is serialized or deserialized.

XmlTypeAttribute

Controla el esquema XML generado cuando XmlSerializer serializa el destino del atributo.Controls the XML schema that is generated when the attribute target is serialized by the XmlSerializer.

XmlTypeMapping

Contiene una asignación de un tipo a otro.Contains a mapping of one type to another.

Estructuras

XmlDeserializationEvents

Contiene campos que se pueden utilizar para pasar los delegados de eventos a un método Deserialize seguro para la ejecución de subprocesos de XmlSerializer.Contains fields that can be used to pass event delegates to a thread-safe Deserialize method of the XmlSerializer.

Interfaces

IXmlSerializable

Proporciona formato personalizado para la serialización y deserialización XML.Provides custom formatting for XML serialization and deserialization.

IXmlTextParser

Establece una propiedad Normalized para ser utilizada por la infraestructura de .NET Framework.Establishes a Normalized property for use by the .NET Framework infrastructure.

Enumeraciones

CodeGenerationOptions

Especifica diversas opciones que se pueden utilizar al generar tipos de .NET Framework para su uso con un servicio web XML.Specifies various options to use when generating .NET Framework types for use with an XML Web Service.

XmlMappingAccess

Especifica si una asignación se lee, se escribe o ambas cosas.Specifies whether a mapping is read, write, or both.

Delegados

UnreferencedObjectEventHandler

Representa el método que controlará el evento UnreferencedObject de un XmlSerializer.Represents the method that handles the UnreferencedObject event of an XmlSerializer.

XmlAttributeEventHandler

Representa el método que controla UnknownAttribute.Represents the method that handles the UnknownAttribute

XmlElementEventHandler

Representa el método que controlará el evento UnknownElement de un XmlSerializer.Represents the method that handles the UnknownElement event of an XmlSerializer.

XmlNodeEventHandler

Representa el método que controlará el evento UnknownNode de un XmlSerializer.Represents the method that handles the UnknownNode event of an XmlSerializer.

XmlSerializationCollectionFixupCallback

Delegado utilizado por la clase XmlSerializer para la deserialización de tipos de datos XML codificados en SOAP que se asignan a colecciones o enumeraciones.Delegate used by the XmlSerializer class for deserialization of SOAP-encoded XML data types that map to collections or enumerations.

XmlSerializationFixupCallback

Delegado utilizado por la clase XmlSerializer para la deserialización de datos XML con codificación SOAP.Delegate used by the XmlSerializer class for deserialization of SOAP-encoded XML data.

XmlSerializationReadCallback

Delegado utilizado por la clase XmlSerializer para la deserialización de tipos con respecto a datos sin raíz XML codificados en SOAP.Delegate used by the XmlSerializer class for deserialization of types from SOAP-encoded, non-root XML data.

XmlSerializationWriteCallback

Delegado utilizado por la clase XmlSerializer para la serialización de tipos de datos XML sin raíz codificados en SOAP.Delegate that is used by the XmlSerializer class for serialization of types from SOAP-encoded, non-root XML data.

Comentarios

La clase central en el espacio de nombres es el XmlSerializer clase.The central class in the namespace is the XmlSerializer class. Para usar esta clase, use el XmlSerializer constructor para crear una instancia de la clase utilizando el tipo del objeto para serializar.To use this class, use the XmlSerializer constructor to create an instance of the class using the type of the object to serialize. Una vez un XmlSerializer está creado, cree una instancia de objeto que se va a serializar.Once an XmlSerializer is created, create an instance of the object to serialize. También debe crear un objeto para escribir el archivo en un documento o una secuencia, como un Stream, TextWriter, o XmlWriter.You must also create an object to write the file to a document or stream, such as a Stream, TextWriter, or XmlWriter. A continuación, puede llamar a la Serialize método para convertir el objeto en un documento XML.You can then call the Serialize method to convert the object into an XML document.

Para deserializar un objeto de un documento XML, crear un objeto adecuado para leer el documento o la secuencia (de nuevo, un Stream, TextWriter, o 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). Invocar el Deserialize método mientras se convierte el objeto resultante en el tipo del objeto original (que se serializó).Invoke the Deserialize method while casting the resulting object to the type of the original object (that was serialized).

Para controlar aún más la serialización, el System.Xml.Serialization espacio de nombres contiene varias Attribute las clases que se pueden aplicar a los miembros de una clase.To further control the serialization, the System.Xml.Serialization namespace contains several Attribute classes that can be applied to members of a class. Por ejemplo, si una clase contiene un miembro que se serializará como un elemento XML, puede aplicar el XmlElementAttribute al miembro de atributo.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. Al aplicar el atributo, puede especificar detalles como el actual elemento XML nombre mediante el ElementName propiedad.When applying the attribute, you can specify details such as the actual XML element name using the ElementName property. Para obtener una lista completa de todos los atributos, vea la XmlSerializer información general de clases.For a complete list of all the attributes, see the XmlSerializer class overview.