.NET Framework Class Librar ...


.NET Framework Class Library for Silverlight
System.Runtime.Serialization Namespace

The System.Runtime.Serialization namespace contains classes that can be used for serializing and deserializing objects.

Serialization is the process of converting an object or a graph of objects into a linear sequence of bytes for either storage or transmission to another location. Deserialization is the process of taking in stored information and re-creating objects from it.

Data Contract Classes

Two notable classes of this namespace are the DataContractAttribute and DataMemberAttribute attribute classes. Apply these attributes (to classes and class members, respectively) when creating Silverlight version 3 clients to specify which members of a class contain data that must be serialized. You can also apply the EnumMemberAttribute to enumeration members to control the XML generated. And apply the CollectionDataContractAttribute to collection classes to control the XML elements generated from collections.

Data Contract Serialization

Another major class is the DataContractSerializer. Use this class to serialize or deserialize instances of classes that have the DataContractAttribute and DataMemberAttribute applied.

To create code from XSD schema documents, use the XsdDataContractImporter. With this class, you can read an XSD document, and generate System.CodeDom components that can be used to generate Visual Basic or Visual C# source code tailored to handling XML data.

Serialization without an Explicit Data Contract

Silverlight 3 also supports a simplified opt-out model for serialization, where these attributes can be omitted from the type and the members of the type to be serialized. The data contract is implicit in the sense that the visibility modifiers (public, private) used by the type determines whether it and its members are included in the data contract. In this model, the name of a member is used to identify it in the serialized representation. A new IgnoreDataMemberAttribute attribute can be used to opt-out a member that is public when required.

For more information about

serialization with an explicit data contract, see Silverlight Serialization.
Classes
  ClassDescription
Public classCollectionDataContractAttributeWhen applied to a collection type, enables custom specification of the collection item elements. This attribute can be applied only to types that are recognized by the DataContractSerializer as valid, serializable collections.
Public classContractNamespaceAttributeSpecifies the CLR namespace and XML namespace of the data contract.
Public classDataContractAttributeSpecifies that the type defines or implements a data contract and can be serialized by a serializer, such as the DataContractSerializer.
Public classDataContractSerializerSerializes and deserializes an instance of a type into an XML stream or document using a supplied data contract. This class cannot be inherited.
Public classDataMemberAttributeWhen applied to the member of a type, specifies that the member is part of a data contract and is serializable by the DataContractSerializer.
Public classEnumMemberAttributeSpecifies that the field is an enumeration member and should be serialized.
Public classIgnoreDataMemberAttributeWhen applied to the member of a type, specifies that the member is not part of a data contract and is not serialized.
Public classInvalidDataContractExceptionThe exception that is thrown when the DataContractSerializer encounters an invalid data contract during serialization and deserialization.
Public classKnownTypeAttributeSpecifies types that should be recognized by the DataContractSerializer when serializing or deserializing a given type.
Public classOnDeserializedAttributeWhen applied to a method, specifies that the method is called immediately after deserialization of the object.
Public classOnDeserializingAttributeWhen applied to a method, specifies that the method is called during deserialization of an object.
Public classOnSerializedAttributeWhen applied to a method, specifies that the method is called after serialization of an object graph.
Public classOnSerializingAttributeWhen applied to a method, specifies that the method is called before serialization of an object.
Public classSerializationExceptionThe exception thrown when an error occurs during serialization or deserialization.
Public classXmlObjectSerializerProvides the base class used to serialize objects as XML streams or documents. This class is abstract.
Structures
  StructureDescription
Public structureStreamingContextDescribes the source and destination of a given serialized stream, and provides an additional caller-defined context.
See Also

Reference

System.Xml.Serialization
System.ServiceModel
System.Xml
Tags :


Page view tracker