Export (0) Print
Expand All
Expand Minimize

System.Xml.Serialization Namespace

The System.Xml.Serialization namespace contains classes that are used to serialize objects into XML format documents or streams.

The central class in the namespace is the XmlSerializer class. To use this class, use the XmlSerializer constructor to create an instance of the class using the type of the object to serialize. Once an XmlSerializer is created, create an instance of the object to serialize. You must also create an object to write the file to a document or stream, such as a Stream, TextWriter, or XmlWriter. You can then call the Serialize method to convert the object into an XML document.

To deserialize an object from an XML document, create a suitable object to read the document or stream (again, a Stream, TextWriter, or XmlWriter). Invoke the Deserialize method while casting the resulting object to the type of the original object (that was serialized).

To further control the serialization, the System.Xml.Serialization namespace contains several Attribute classes that can be applied to members of a class. 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. When applying the attribute, you can specify details such as the actual XML element name using the ElementName property. For a complete list of all the attributes, see the XmlSerializer class overview.

 ClassDescription
Public classCodeExporterRepresents a class that can generate proxy code from an XML representation of a data structure.
Public classCodeIdentifierProvides static methods to convert input text into names for code entities.
Public classCodeIdentifiersMaintains a group of names for related code entities or type mappings that are generated by the .NET Framework's XML serialization infrastructure.
Public classImportContextDescribes the context in which a set of schema is bound to .NET Framework code entities.
Public classSchemaImporterDescribes a schema importer.
Public classSoapAttributeAttributeSpecifies that the XmlSerializer must serialize the class member as an encoded SOAP attribute.
Public classSoapAttributeOverridesAllows you to override attributes applied to properties, fields, and classes when you use an XmlSerializer to serialize or deserialize an object as encoded SOAP.
Public classSoapAttributesRepresents a collection of attribute objects that control how the XmlSerializer serializes and deserializes SOAP methods.
Public classSoapCodeExporterGenerates types and attribute declarations from internal type mapping information for SOAP-encoded message parts defined in a WSDL document.
Public classSoapElementAttributeSpecifies that the public member value be serialized by the XmlSerializer as an encoded SOAP XML element.
Public classSoapEnumAttributeControls how the XmlSerializer serializes an enumeration member.
Public classSoapIgnoreAttributeInstructs the XmlSerializer not to serialize the public field or public read/write property value.
Public classSoapIncludeAttributeAllows the XmlSerializer to recognize a type when it serializes or deserializes an object as encoded SOAP XML.
Public classSoapReflectionImporterGenerates mappings to SOAP-encoded messages from .NET Framework types or Web service method information.
Public classSoapSchemaExporterPopulates XmlSchema objects with XML Schema data type definitions for .NET Framework types that are serialized using SOAP encoding.
Public classSoapSchemaImporterUsed within the .NET Framework to generate internal mappings to .NET Framework types for SOAP-encoded message parts in a WSDL document.
Public classSoapSchemaMemberRepresents certain attributes of a XSD <part> element in a WSDL document for generating classes from the document.
Public classSoapTypeAttributeControls the schema generated by the XmlSerializer when a class instance is serialized as SOAP encoded XML.
Public classUnreferencedObjectEventArgsProvides data for the known, but unreferenced, object found in an encoded SOAP XML stream during deserialization.
Public classXmlAnyAttributeAttributeSpecifies that the member (a field that returns an array of XmlAttribute objects) can contain any XML attributes.
Public classXmlAnyElementAttributeSpecifies 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.
Public classXmlAnyElementAttributesRepresents a collection of XmlAnyElementAttribute objects.
Public classXmlArrayAttributeSpecifies that the XmlSerializer must serialize a particular class member as an array of XML elements.
Public classXmlArrayItemAttributeSpecifies the derived types that the XmlSerializer can place in a serialized array.
Public classXmlArrayItemAttributesRepresents a collection of XmlArrayItemAttribute objects.
Public classXmlAttributeAttributeSpecifies that the XmlSerializer must serialize the class member as an XML attribute.
Public classXmlAttributeEventArgsProvides data for the UnknownAttribute event.
Public classXmlAttributeOverridesAllows you to override property, field, and class attributes when you use the XmlSerializer to serialize or deserialize an object.
Public classXmlAttributesRepresents a collection of attribute objects that control how the XmlSerializer serializes and deserializes an object.
Public classXmlChoiceIdentifierAttributeSpecifies that the member can be further detected by using an enumeration.
Public classXmlCodeExporterGenerates types and attribute declarations from internal type mapping information for XML schema element declarations.
Public classXmlElementAttributeIndicates that a public field or property represents an XML element when the XmlSerializer serializes or deserializes the object that contains it.
Public classXmlElementAttributesRepresents a collection of XmlElementAttribute objects used by the XmlSerializer to override the default way it serializes a class.
Public classXmlElementEventArgsProvides data for the UnknownElement event.
Public classXmlEnumAttributeControls how the XmlSerializer serializes an enumeration member.
Public classXmlIgnoreAttributeInstructs the Serialize method of the XmlSerializer not to serialize the public field or public read/write property value.
Public classXmlIncludeAttributeAllows the XmlSerializer to recognize a type when it serializes or deserializes an object.
Public classXmlMappingSupports mappings between .NET Framework types and XML Schema data types.
Public classXmlMemberMappingMaps a code entity in a .NET Framework Web service method to an element in a Web Services Description Language (WSDL) message.
Public classXmlMembersMappingProvides mappings between .NET Framework Web service methods and Web Services Description Language (WSDL) messages that are defined for SOAP Web services.
Public classXmlNamespaceDeclarationsAttributeSpecifies that the target property, parameter, return value, or class member contains prefixes associated with namespaces that are used within an XML document.
Public classXmlNodeEventArgsProvides data for the UnknownNode event.
Public classXmlReflectionImporterGenerates 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.
Public classXmlReflectionMemberProvides 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.
Public classXmlRootAttributeControls XML serialization of the attribute target as an XML root element.
Public classXmlSchemaEnumeratorEnables iteration over a collection of XmlSchema objects.
Public classXmlSchemaExporterPopulates XmlSchema objects with XML schema element declarations that are found in type mapping objects.
Public classXmlSchemaImporterGenerates internal mappings to .NET Framework types for XML schema element declarations, including literal XSD message parts in a WSDL document.
Public classXmlSchemaProviderAttributeWhen applied to a type, stores the name of a static method of the type that returns an XML schema and a XmlQualifiedName that controls the serialization of the type.
Public classXmlSchemasRepresents the collection of XML schemas.
Public classXmlSerializationGeneratedCodeAn abstract class that is the base class for XmlSerializationReader and XmlSerializationWriter and that contains methods common to both of these types.
Public classXmlSerializationReaderControls deserialization by the XmlSerializer class.
Public classXmlSerializationReader.CollectionFixupHolds an XmlSerializationCollectionFixupCallback delegate instance, plus the method's inputs; also supplies the method's parameters.
Public classXmlSerializationReader.FixupHolds an XmlSerializationFixupCallback delegate instance, plus the method's inputs; also serves as the parameter for the method.
Public classXmlSerializationWriterAbstract class used for controlling serialization by the XmlSerializer class.
Public classXmlSerializerSerializes and deserializes objects into and from XML documents. The XmlSerializer enables you to control how objects are encoded into XML.
Public classXmlSerializerAssemblyAttributeApplied to a Web service client proxy, enables you to specify an assembly that contains custom-made serializers.
Public classXmlSerializerFactoryCreates typed versions of the XmlSerializer for more efficient serialization.
Public classXmlSerializerImplementationDefines the reader, writer, and methods for pre-generated, typed serializers.
Public classXmlSerializerNamespacesContains the XML namespaces and prefixes that the XmlSerializer uses to generate qualified names in an XML-document instance.
Public classXmlSerializerVersionAttributeSignifies that the code was generated by the serialization infrastructure and can be reused for increased performance, when this attribute is applied to an assembly.
Public classXmlTextAttributeIndicates to the XmlSerializer that the member must be treated as XML text when the class that contains it is serialized or deserialized.
Public classXmlTypeAttributeControls the XML schema that is generated when the attribute target is serialized by the XmlSerializer.
Public classXmlTypeMappingContains a mapping of one type to another.

 InterfaceDescription
Public interfaceIXmlSerializableProvides custom formatting for XML serialization and deserialization.
Public interfaceIXmlTextParserEstablishes a Normalized property for use by the .NET Framework infrastructure.

 StructureDescription
Public structureXmlDeserializationEventsContains fields that can be used to pass event delegates to a thread-safe Deserialize method of the XmlSerializer.

 DelegateDescription
Public delegateUnreferencedObjectEventHandlerRepresents the method that handles the UnreferencedObject event of an XmlSerializer.
Public delegateXmlAttributeEventHandlerRepresents the method that handles the UnknownAttribute
Public delegateXmlElementEventHandlerRepresents the method that handles the UnknownElement event of an XmlSerializer.
Public delegateXmlNodeEventHandlerRepresents the method that handles the UnknownNode event of an XmlSerializer.
Public delegateXmlSerializationCollectionFixupCallbackDelegate used by the XmlSerializer class for deserialization of SOAP-encoded XML data types that map to collections or enumerations.
Public delegateXmlSerializationFixupCallbackDelegate used by the XmlSerializer class for deserialization of SOAP-encoded XML data.
Public delegateXmlSerializationReadCallbackDelegate used by the XmlSerializer class for deserialization of types from SOAP-encoded, non-root XML data.
Public delegateXmlSerializationWriteCallbackDelegate that is used by the XmlSerializer class for serialization of types from SOAP-encoded, non-root XML data.

 EnumerationDescription
Public enumerationCodeGenerationOptionsSpecifies various options to use when generating .NET Framework types for use with an XML Web Service.
Public enumerationXmlMappingAccessSpecifies whether a mapping is read, write, or both.

Community Additions

ADD
Show:
© 2014 Microsoft