NetDataContractSerializer.WriteStartObject Method

Definition

Namespace:

System.Runtime.Serialization

Assembly:

System.Runtime.Serialization.dll

Writes the opening XML element using the specified writer.

Overloads

WriteStartObject(XmlDictionaryWriter, Object)	Writes the opening XML element using an XmlDictionaryWriter.
WriteStartObject(XmlWriter, Object)	Writes the opening XML element using an XmlWriter.

WriteStartObject(XmlDictionaryWriter, Object)

Writes the opening XML element using an XmlDictionaryWriter.

public:
 override void WriteStartObject(System::Xml::XmlDictionaryWriter ^ writer, System::Object ^ graph);

public override void WriteStartObject (System.Xml.XmlDictionaryWriter writer, object graph);

override this.WriteStartObject : System.Xml.XmlDictionaryWriter * obj -> unit

Public Overrides Sub WriteStartObject (writer As XmlDictionaryWriter, graph As Object)

Parameters

writer

XmlDictionaryWriter

The XmlDictionaryWriter used to write the XML element.

graph

Object

The object to serialize. All child objects of this root object are automatically serialized.

Exceptions

InvalidDataContractException

the type being serialized does not conform to data contract rules. For example, the DataContractAttribute attribute has not been applied to the type.

SerializationException

there is a problem with the instance being serialized.

QuotaExceededException

the maximum number of object to serialize has been exceeded. Check the MaxItemsInObjectGraph property.

Examples

The following example creates an object to serialize, an instance of the NetDataContractSerializer, and an instance of the XmlDictionaryWriter class. The example uses the WriteStartObject, WriteObjectContent, and WriteEndObject methods to write the object data into the XML document.

public sealed class ShowWriteStartObject
{

    public static void WriteObjectData(string path)
    {
        // Create the object to serialize.
        Person p = new Person("Lynn", "Tsoflias", 9876);

        // Create the writer.
        FileStream fs = new FileStream(path, FileMode.Create);
        XmlDictionaryWriter writer =
            XmlDictionaryWriter.CreateTextWriter(fs);

        NetDataContractSerializer ser =
            new NetDataContractSerializer();

        // Use the writer to start a document.
        writer.WriteStartDocument(true);

        // Use the serializer to write the start of the
        // object data. Use it again to write the object
        // data.
        ser.WriteStartObject(writer, p);
        ser.WriteObjectContent(writer, p);

        // Use the serializer to write the end of the
        // object data. Then use the writer to write the end
        // of the document.
        ser.WriteEndObject(writer);
        writer.WriteEndDocument();

        Console.WriteLine("Done");

        // Close and release the writer resources.
        writer.Flush();
        fs.Flush();
        fs.Close();
    }

NotInheritable Public Class ShowWriteStartObject
     
    Public Shared Sub WriteObjectData(ByVal path As String) 
        ' Create the object to serialize.
        Dim p As New Person("Lynn", "Tsoflias", 9876)
        
        ' Create the writer.
        Dim fs As New FileStream(path, FileMode.Create)
        Dim writer As XmlDictionaryWriter = XmlDictionaryWriter.CreateTextWriter(fs)
        
        Dim ser As New System.Runtime.Serialization.NetDataContractSerializer()        

        ' Use the writer to start a document.
        writer.WriteStartDocument(True)
        
        ' Use the serializer to write the start of the 
        ' object data. Use it again to write the object
        ' data. 
        ser.WriteStartObject(writer, p)
        writer.WriteStartAttribute("MyAttribute")
        writer.WriteString("My Text")
        writer.WriteEndAttribute()

        ser.WriteObjectContent(writer, p)
                
        ' Use the serializer to write the end of the 
        ' object data. Then use the writer to write the end
        ' of the document.
        ser.WriteEndObject(writer)
        writer.WriteEndDocument()
        
        Console.WriteLine("Done")
        
        ' Close and release the writer resources.
        writer.Flush()
        fs.Flush()
        fs.Close()
    
    End Sub

WriteStartObject(XmlWriter, Object)

Writes the opening XML element using an XmlWriter.

public:
 override void WriteStartObject(System::Xml::XmlWriter ^ writer, System::Object ^ graph);

public override void WriteStartObject (System.Xml.XmlWriter writer, object graph);

override this.WriteStartObject : System.Xml.XmlWriter * obj -> unit

Public Overrides Sub WriteStartObject (writer As XmlWriter, graph As Object)

Parameters

writer

XmlWriter

The XmlDictionaryWriter used to write the XML element.

graph

Object

The object to serialize. All child objects of this root object are automatically serialized.

Exceptions

InvalidDataContractException

the type being serialized does not conform to data contract rules. For example, the DataContractAttribute attribute has not been applied to the type.

SerializationException

there is a problem with the instance being serialized.

QuotaExceededException

the maximum number of object to serialize has been exceeded. Check the MaxItemsInObjectGraph property.