System.Xml.Serialization (Espacio de nombres)

Cambiar vista:
Sin script
System.Xml.Serialization (Espacio de nombres)
El espacio de nombres System.Xml.Serialization contiene clases que se utilizan para serializar objetos en secuencias o documentos con formato XML.

La clase central en el espacio de nombres es la clase XmlSerializer. Para utilizar esta clase, use el constructor XmlSerializer con el fin de crear una instancia de la clase utilizando el tipo de objeto que se va a serializar. Tras crear XmlSerializer, cree una instancia del objeto que se va a serializar. También hay que crear un objeto para escribir el archivo en un documento o una secuencia, como Stream, TextWriter o XmlWriter. A continuación, hay que llamar al método Serialize para convertir el objeto en un documento XML.

Para deserializar un objeto de un documento XML, hay que crear un objeto adecuado con el fin de leer el documento o la secuencia (de nuevo, Stream, TextWriter o XmlWriter). Invoque al método Deserialize mientras se convierte el objeto resultante en el tipo del objeto original (serializado).

Para controlar la serialización, el espacio de nombres System.Xml.Serialization contiene varias clases Attribute que se pueden aplicar a los miembros de una clase. Por ejemplo, si una clase contiene un miembro que se serializará como un elemento XML, se puede aplicar el atributo XmlElementAttribute al miembro. Al aplicar el atributo, se puede especificar información detallada como el nombre de elemento XML real mediante la propiedad ElementName. Para obtener una lista completa de todos los atributos, vea la información general de la clase XmlSerializer.

Clases

  Clase Descripción
Clase pública CodeExporter Representa una clase que puede generar el código proxy de una representación XML de una estructura de datos.
Clase pública CodeIdentifier Proporciona métodos estáticos para convertir el texto de entrada en nombres para las entidades de código.
Clase pública 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.
Clase pública ImportContext Describe el contexto en el que un conjunto de esquema se enlaza a las entidades de código de .NET Framework.
Clase pública SchemaImporter Describe un importador de esquemas.
Clase pública SoapAttributeAttribute Especifica que XmlSerializer debe serializar el miembro de clase como un atributo SOAP codificado.
Clase pública 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.
Clase pública SoapAttributes Representa a una colección de objetos de atributos que controlan el modo en que XmlSerializer serializa y deserializa los métodos SOAP.
Clase pública 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.
Clase pública SoapElementAttribute Especifica que XmlSerializer debe serializar el valor del miembro público como un elemento XML SOAP codificado.
Clase pública SoapEnumAttribute Controla el modo en que XmlSerializer serializa un miembro de enumeración.
Clase pública SoapIgnoreAttribute Instruye al XmlSerializer para que no serialice el valor de campo público o propiedad pública de lectura/escritura.
Clase pública SoapIncludeAttribute Permite que XmlSerializer reconozca un tipo al serializar o deserializar un objeto como XML SOAP codificado.
Clase pública 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.
Clase pública 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.
Clase pública 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.
Clase pública SoapSchemaMember Representa ciertos atributos de un elemento de la <part> XSD en un documento WSDL para generar las clases a partir del documento.
Clase pública SoapTypeAttribute Controla el esquema generado por XmlSerializer cuando se serializa una instancia de clase como XML SOAP codificado.
Clase pública UnreferencedObjectEventArgs Proporciona datos del objeto conocido, pero sin referencia, detectado en una secuencia XML SOAP codificada durante la deserialización.
Clase pública XmlAnyAttributeAttribute Especifica que el miembro (un campo que devuelve una matriz de objetos XmlAttribute) puede contener cualquier atributo XML.
Clase pública 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.
Clase pública XmlAnyElementAttributes Representa una colección de objetos XmlAnyElementAttribute.
Clase pública XmlArrayAttribute Especifica que XmlSerializer debe serializar un miembro de clase determinado como matriz de elementos XML.
Clase pública XmlArrayItemAttribute Especifica los tipos derivados que XmlSerializer puede colocar en una matriz serializada.
Clase pública XmlArrayItemAttributes Representa una colección de objetos XmlArrayItemAttribute.
Clase pública XmlAttributeAttribute Especifica que XmlSerializer debe serializar el miembro de la clase como un atributo XML.
Clase pública XmlAttributeEventArgs Proporciona los datos del evento UnknownAttribute.
Clase pública XmlAttributeOverrides Permite reemplazar los atributos de las propiedades, campos y clases al utilizar XmlSerializer para serializar o deserializar un objeto.
Clase pública XmlAttributes Representa una colección de objetos de atributo que controlan el modo en que XmlSerializer serializa y deserializa un objeto.
Clase pública XmlChoiceIdentifierAttribute Especifica que el miembro se puede detectar mejor utilizando una enumeración.
Clase pública XmlCodeExporter Genera tipos y declaraciones de atributos de información de asignación de tipos interna para las declaraciones del elemento de esquema XML.
Clase pública 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.
Clase pública XmlElementAttributes Representa una colección de objetos XmlElementAttribute, que XmlSerializer utiliza para reemplazar la forma predeterminada en que serializa una clase.
Clase pública XmlElementEventArgs Proporciona datos para el evento UnknownElement.
Clase pública XmlEnumAttribute Controla el modo en que XmlSerializer serializa un miembro de enumeración.
Clase pública XmlIgnoreAttribute Instruye al método Serialize de XmlSerializer para que no serialice el valor de campo público o propiedad pública de lectura/escritura.
Clase pública XmlIncludeAttribute Permite que XmlSerializer reconozca un tipo al serializar o deserializar un objeto.
Clase pública XmlMapping Admite asignaciones entre tipos de .NET Framework y tipos de datos de esquemas XML.
Clase pública 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).
Clase pública 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.
Clase pública 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.
Clase pública XmlNodeEventArgs Proporciona datos para el evento UnknownNode.
Clase pública 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.
Clase pública 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.
Clase pública XmlRootAttribute Controla la serialización XML del destino de atributo como elemento raíz XML.
Clase pública XmlSchemaEnumerator Habilita la iteración sobre una colección de objetos XmlSchema.
Clase pública XmlSchemaExporter Rellena los objetos XmlSchema con declaraciones del elemento de esquema XML que se encuentran en los objetos de asignación de tipo.
Clase pública 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.
Clase pública 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.
Clase pública XmlSchemas Representa la colección de esquemas XML.
Clase pública XmlSerializationGeneratedCode Clase abstracta que es la clase base para XmlSerializationReader y XmlSerializationWriter y que contiene los métodos comunes a ambos tipos.
Clase pública XmlSerializationReader Controla la deserialización por la clase XmlSerializer.
Clase pública XmlSerializationReader.CollectionFixup Contiene una instancia de delegado XmlSerializationCollectionFixupCallback, más las entradas del método; también proporciona los parámetros del método.
Clase pública 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.
Clase pública XmlSerializationWriter Clase abstracta utilizada para controlar la serialización realizada por la clase XmlSerializer.
Clase pública XmlSerializer Serializa y deserializa objetos en y desde documentos XML. XmlSerializer permite controlar el modo en que se codifican los objetos en XML.
Clase pública XmlSerializerAssemblyAttribute Aplicado a un proxy cliente de servicios Web, le permite especificar un ensamblado que contiene los serializadores hechos a medida.
Clase pública XmlSerializerFactory Crea versiones con establecimiento de tipos de XmlSerializer para una serialización más eficaz.
Clase pública XmlSerializerImplementation Define el lector, el escritor y los métodos para los serializadores con establecimiento de tipos generados previamente.
Clase pública XmlSerializerNamespaces Contiene los espacios de nombres XML y prefijos que XmlSerializer utiliza para generar nombres cualificados en una instancia de documento XML.
Clase pública 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.
Clase pública XmlTextAttribute Indica a XmlSerializer que el miembro debe tratarse como texto XML cuando se serializa o se deserializa la clase contenedora.
Clase pública XmlTypeAttribute Controla el esquema XML generado cuando XmlSerializer serializa el destino del atributo.
Clase pública XmlTypeMapping Contiene una asignación de un tipo a otro.
Interfaces

  Interfaz Descripción
Interfaz pública IXmlSerializable Proporciona formato personalizado para la serialización y deserialización XML.
Interfaz pública IXmlTextParser Establece una propiedad Normalized para ser utilizada por la infraestructura de .NET Framework.
Estructuras

  Estructura Descripción
Estructura pública 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.
Delegados

  Delegado Descripción
Delegado público UnreferencedObjectEventHandler Representa el método que controlará el evento UnreferencedObject de un XmlSerializer.
Delegado público XmlAttributeEventHandler Representa el método que controla UnknownAttribute.
Delegado público XmlElementEventHandler Representa el método que controlará el evento UnknownElement de un XmlSerializer.
Delegado público XmlNodeEventHandler Representa el método que controlará el evento UnknownNode de un XmlSerializer.
Delegado público 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.
Delegado público XmlSerializationFixupCallback Delegado utilizado por la clase XmlSerializer para la deserialización de datos XML con codificación SOAP.
Delegado público XmlSerializationReadCallback Delegado utilizado por la clase XmlSerializer para la deserialización de tipos con respecto a datos sin raíz XML codificados en SOAP.
Delegado público XmlSerializationWriteCallback Delegado utilizado por la clase XmlSerializer para la serialización de tipos de datos XML sin raíz codificados en SOAP.
Enumeraciones

  Enumeración Descripción
Enumeración pública CodeGenerationOptions Especifica diversas opciones que se pueden utilizar al generar tipos de .NET Framework para su uso con un servicio Web XML.
Enumeración pública XmlMappingAccess Especifica si una asignación se lee, se escribe o ambas cosas.