NetDataContractSerializer.WriteStartObject Method

Definition

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.

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

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

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

there is a problem with the instance being serialized.

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.

C#
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();
    }

Applies to

.NET Framework 4.8.1 and other versions
Product Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

WriteStartObject(XmlWriter, Object)

Writes the opening XML element using an XmlWriter.

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

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

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

there is a problem with the instance being serialized.

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

Applies to

.NET Framework 4.8.1 and other versions
Product Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1