DataContractSerializer.WriteEndObject 方法

定義

命名空間:

System.Runtime.Serialization

組件:

System.Runtime.Serialization.Xml.dll

使用指定的寫入器寫入結尾 XML 項目。

多載

WriteEndObject(XmlDictionaryWriter)	使用 XmlDictionaryWriter 寫入結尾 XML 項目。
WriteEndObject(XmlWriter)	使用 XmlWriter 寫入結尾 XML 項目。

WriteEndObject(XmlDictionaryWriter)

來源:

DataContractSerializer.cs

使用 XmlDictionaryWriter 寫入結尾 XML 項目。

public:
 override void WriteEndObject(System::Xml::XmlDictionaryWriter ^ writer);

public override void WriteEndObject (System.Xml.XmlDictionaryWriter writer);

override this.WriteEndObject : System.Xml.XmlDictionaryWriter -> unit

Public Overrides Sub WriteEndObject (writer As XmlDictionaryWriter)

參數

writer

XmlDictionaryWriter

用於寫入資料流的 XmlDictionaryWriter。

例外狀況

InvalidDataContractException

正在序列化的型別不符合資料合約規則。 例如，DataContractAttribute 屬性尚未套用至此型別。

SerializationException

正在寫入的執行個體發生問題。

範例

下列範例會建立要序列化的物件、DataContractSerializer 的執行個體和 XmlDictionaryWriter 類別的執行個體。 這個範例使用 WriteStartObject、WriteObjectContent 和 WriteObjectContent 方法，將物件資料寫入 XML 文件。 發出這些呼叫相當於發出 WriteObject 方法的單一呼叫。 例如，使用者可能在呼叫 WriteStartObject 方法之後，另外發出這些呼叫來將額外的 XML 屬性插入 XML 中。

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

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

    DataContractSerializer ser =
        new DataContractSerializer(typeof(Person));

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

    // Use the writer to write the root element.
    writer.WriteStartElement("Company");

    // Use the writer to write an element.
    writer.WriteElementString("Name", "Microsoft");

    // Use the serializer to write the start,
    // content, and end data.
    ser.WriteStartObject(writer, p);
    ser.WriteObjectContent(writer, p);
    ser.WriteEndObject(writer);

    // Use the writer to write the end element and
    // the end of the document.
    writer.WriteEndElement();
    writer.WriteEndDocument();

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

Public Shared Sub WriteObjectContentInDocument(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 DataContractSerializer(GetType(Person))
    
    ' Use the writer to start a document.
    writer.WriteStartDocument(True)
    ' Use the writer to write the root element.
    writer.WriteStartElement("Company")
    ' Use the writer to write an element.
    writer.WriteElementString("Name", "Microsoft")

    ' Use the serializer to write the start,
    ' content, and end data.
    ser.WriteStartObject(writer, p)
    ser.WriteObjectContent(writer, p)
    ser.WriteEndObject(writer)
    
    ' Use the writer to write the end element and
    ' the end of the document.
    writer.WriteEndElement()
    writer.WriteEndDocument()
    
    ' Close and release the writer resources.
    writer.Flush()
    fs.Flush()
    fs.Close()

End Sub

WriteEndObject(XmlWriter)

來源:

DataContractSerializer.cs

使用 XmlWriter 寫入結尾 XML 項目。

public:
 override void WriteEndObject(System::Xml::XmlWriter ^ writer);

public override void WriteEndObject (System.Xml.XmlWriter writer);

override this.WriteEndObject : System.Xml.XmlWriter -> unit

Public Overrides Sub WriteEndObject (writer As XmlWriter)

參數

writer

XmlWriter

用於寫入資料流的 XmlWriter。

例外狀況

InvalidDataContractException

正在序列化的型別不符合資料合約規則。 例如，DataContractAttribute 屬性尚未套用至此型別。

SerializationException

正在寫入的執行個體發生問題。