XmlObjectSerializer.WriteObject 方法

定義

命名空間:

System.Runtime.Serialization

組件:

System.Runtime.Serialization.dll

將所有物件資料（起始 XML 元素、內容及結尾元素）寫入 XML 文件或串流。

多載

名稱	Description
WriteObject(Stream, Object)	將物件的完整內容（起始、內容及結束）寫入 XML 文件或串流，並指定為 Stream。
WriteObject(XmlDictionaryWriter, Object)	將物件的完整內容（起始、內容及結束）寫入 XML 文件或串流，並指定為 XmlDictionaryWriter。
WriteObject(XmlWriter, Object)	將物件的完整內容（起始、內容及結束）寫入 XML 文件或串流，並指定為 XmlWriter。

WriteObject(Stream, Object)

將物件的完整內容（起始、內容及結束）寫入 XML 文件或串流，並指定為 Stream。

public:
 virtual void WriteObject(System::IO::Stream ^ stream, System::Object ^ graph);

public virtual void WriteObject(System.IO.Stream stream, object graph);

abstract member WriteObject : System.IO.Stream * obj -> unit
override this.WriteObject : System.IO.Stream * obj -> unit

Public Overridable Sub WriteObject (stream As Stream, graph As Object)

參數

stream

Stream

Stream A 用於撰寫 XML 文件或串流。

graph

Object

包含要寫入串流資料的物件。

例外狀況

InvalidDataContractException

被序列化的類型不符合資料合約規則。 例如， DataContractAttribute 屬性尚未套用到型別。

SerializationException

實例被序列化時存在問題。

QuotaExceededException

序列化物件的最大數量已被超越。 檢查 MaxItemsInObjectGraph 屬性。

WriteObject(XmlDictionaryWriter, Object)

將物件的完整內容（起始、內容及結束）寫入 XML 文件或串流，並指定為 XmlDictionaryWriter。

public:
 virtual void WriteObject(System::Xml::XmlDictionaryWriter ^ writer, System::Object ^ graph);

public virtual void WriteObject(System.Xml.XmlDictionaryWriter writer, object graph);

abstract member WriteObject : System.Xml.XmlDictionaryWriter * obj -> unit
override this.WriteObject : System.Xml.XmlDictionaryWriter * obj -> unit

Public Overridable Sub WriteObject (writer As XmlDictionaryWriter, graph As Object)

參數

writer

XmlDictionaryWriter

XmlDictionaryWriter用於將內容寫入 XML 文件或串流。

graph

Object

包含要寫入內容的物件。

例外狀況

InvalidDataContractException

被序列化的類型不符合資料合約規則。 例如， DataContractAttribute 屬性尚未套用到型別。

SerializationException

實例被序列化時存在問題。

QuotaExceededException

序列化物件的最大數量已被超越。 檢查 MaxItemsInObjectGraph 屬性。

備註

這是一個虛擬方法，預設實作會呼叫 WriteStartObject、 WriteObjectContent和 WriteEndObject 方法。 因此，這種方法被設計成串列器上最常用的方法。

WriteObject(XmlWriter, Object)

將物件的完整內容（起始、內容及結束）寫入 XML 文件或串流，並指定為 XmlWriter。

public:
 virtual void WriteObject(System::Xml::XmlWriter ^ writer, System::Object ^ graph);

public virtual void WriteObject(System.Xml.XmlWriter writer, object graph);

abstract member WriteObject : System.Xml.XmlWriter * obj -> unit
override this.WriteObject : System.Xml.XmlWriter * obj -> unit

Public Overridable Sub WriteObject (writer As XmlWriter, graph As Object)

參數

writer

XmlWriter

XmlWriter用於撰寫 XML 文件或串流。

graph

Object

包含要寫入內容的物件。

例外狀況

InvalidDataContractException

被序列化的類型不符合資料合約規則。 例如， DataContractAttribute 屬性尚未套用到型別。

SerializationException

實例被序列化時存在問題。

QuotaExceededException

序列化物件的最大數量已被超越。 檢查 MaxItemsInObjectGraph 屬性。

備註

這是一種虛擬方法，且預設實作將寫入委派給過載。XmlObjectSerializer.WriteObject(XmlDictionaryWriter, Object)