System.Xml.Serialization Espacio de nombres
Contiene clases que se usan para serializar objetos en documentos o secuencias de formato XML. 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 tipos relacionadas que son generadas por la infraestructura de serialización XML de .NET.Maintains a group of names for related code entities or type mappings that are generated by .NET's XML serialization infrastructure. |
ImportContext |
Describe el contexto en el que un conjunto de esquemas se enlaza a las entidades de código .NET.Describes the context in which a set of schema is bound to .NET 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 mensajes con codificación SOAP desde los tipos .NET o la información de métodos de servicio Web.Generates mappings to SOAP-encoded messages from .NET 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 < |
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 con 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 usa para reemplazar el modo predeterminado 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 .NET y tipos de datos de esquema XML.Supports mappings between .NET types and XML Schema data types. |
XmlMemberMapping |
Asigna una entidad de código de un método del servicio Web de .NET a un elemento de un mensaje escrito en Lenguaje de descripción de servicios Web (WSDL).Maps a code entity in a .NET 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 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 Web service methods and Web Services Description Language (WSDL) messages that are defined for SOAP Web services. |
XmlNamespaceDeclarationsAttribute |
Especifica que la propiedad, el parámetro, el valor devuelto o el miembro de clase de destino contiene prefijos asociados a espacios de nombres que se usan 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 literales del mensaje de definición de esquema XML (XSD) de un documento escrito en lenguaje de descripción de servicios Web (WSDL), para los tipos .NET 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 types or Web service method information. |
XmlReflectionMember |
Proporciona asignaciones entre entidades de código de los métodos del servicio Web de .NET 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 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 |
Permite la iteración en 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 asignaciones internas a tipos .NET para las declaraciones de elementos de esquema XML, incluidas las partes literales del mensaje XSD en un documento WSDL.Generates internal mappings to .NET 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 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 un formato personalizado para la serialización y deserialización XML.Provides custom formatting for XML serialization and deserialization. |
IXmlTextParser |
Establece una propiedad Normalized para que la utilice la infraestructura de .NET.Establishes a Normalized property for use by the .NET infrastructure. |
Enumeraciones
CodeGenerationOptions |
Especifica diversas opciones que se pueden usar al generar tipos de .NET para su uso con un servicio web XML.Specifies various options to use when generating .NET 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 del espacio de nombres es la 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 que se va a 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 XmlSerializer creado, cree una instancia del 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 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. Después, puede llamar al 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 a partir de un documento XML, cree un objeto adecuado para leer el documento o la secuencia (de nuevo,, 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). Invoque el Deserialize método mientras convierte el objeto resultante al 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 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 atributo al miembro.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 nombre del elemento XML real mediante la 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 la clase.For a complete list of all the attributes, see the XmlSerializer class overview.