XmlObjectSerializer.WriteStartObject 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
僅將起始的 XML 元素寫入 XML 文件或串流。
多載
| 名稱 | Description |
|---|---|
| WriteStartObject(XmlDictionaryWriter, Object) |
使用指定的 XmlDictionaryWriter。 |
| WriteStartObject(XmlWriter, Object) |
使用指定的 XmlWriter。 |
備註
WriteStartObject必須實作 、 WriteObjectContent和 WriteEndObject 方法。 三種方法依序使用,透過以下模式撰寫完整的序列化:write start、write content 和 write end。 若實作使用 XML 元素撰寫,則可在寫入物件內容前插入屬性。 這三種方法也由該方法的 WriteObject 虛擬實作所呼叫。
WriteStartObject(XmlDictionaryWriter, Object)
使用指定的 XmlDictionaryWriter。
public:
abstract void WriteStartObject(System::Xml::XmlDictionaryWriter ^ writer, System::Object ^ graph);
public abstract void WriteStartObject(System.Xml.XmlDictionaryWriter writer, object graph);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Data Contract Serialization and Deserialization might require types that cannot be statically analyzed.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Data Contract Serialization and Deserialization might require types that cannot be statically analyzed. Make sure all of the required types are preserved.")]
public abstract void WriteStartObject(System.Xml.XmlDictionaryWriter writer, object? graph);
public abstract void WriteStartObject(System.Xml.XmlDictionaryWriter writer, object? graph);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Data Contract Serialization and Deserialization might require types that cannot be statically analyzed. Make sure all of the required types are preserved.")]
public abstract void WriteStartObject(System.Xml.XmlDictionaryWriter writer, object? graph);
abstract member WriteStartObject : System.Xml.XmlDictionaryWriter * obj -> unit
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Data Contract Serialization and Deserialization might require types that cannot be statically analyzed.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Data Contract Serialization and Deserialization might require types that cannot be statically analyzed. Make sure all of the required types are preserved.")>]
abstract member WriteStartObject : System.Xml.XmlDictionaryWriter * obj -> unit
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Data Contract Serialization and Deserialization might require types that cannot be statically analyzed. Make sure all of the required types are preserved.")>]
abstract member WriteStartObject : System.Xml.XmlDictionaryWriter * obj -> unit
Public MustOverride Sub WriteStartObject (writer As XmlDictionaryWriter, graph As Object)
參數
- writer
- XmlDictionaryWriter
XmlDictionaryWriter用來撰寫 XML 文件。
- graph
- Object
要串連的物件。
- 屬性
例外狀況
被序列化的類型不符合資料合約規則。 例如, DataContractAttribute 屬性尚未套用到型別。
實例被序列化時存在問題。
序列化物件的最大數量已被超越。 檢查 MaxItemsInObjectGraph 屬性。
適用於
WriteStartObject(XmlWriter, Object)
使用指定的 XmlWriter。
public:
virtual void WriteStartObject(System::Xml::XmlWriter ^ writer, System::Object ^ graph);
public virtual void WriteStartObject(System.Xml.XmlWriter writer, object graph);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Data Contract Serialization and Deserialization might require types that cannot be statically analyzed.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Data Contract Serialization and Deserialization might require types that cannot be statically analyzed. Make sure all of the required types are preserved.")]
public virtual void WriteStartObject(System.Xml.XmlWriter writer, object? graph);
public virtual void WriteStartObject(System.Xml.XmlWriter writer, object? graph);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Data Contract Serialization and Deserialization might require types that cannot be statically analyzed. Make sure all of the required types are preserved.")]
public virtual void WriteStartObject(System.Xml.XmlWriter writer, object? graph);
abstract member WriteStartObject : System.Xml.XmlWriter * obj -> unit
override this.WriteStartObject : System.Xml.XmlWriter * obj -> unit
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Data Contract Serialization and Deserialization might require types that cannot be statically analyzed.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Data Contract Serialization and Deserialization might require types that cannot be statically analyzed. Make sure all of the required types are preserved.")>]
abstract member WriteStartObject : System.Xml.XmlWriter * obj -> unit
override this.WriteStartObject : System.Xml.XmlWriter * obj -> unit
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Data Contract Serialization and Deserialization might require types that cannot be statically analyzed. Make sure all of the required types are preserved.")>]
abstract member WriteStartObject : System.Xml.XmlWriter * obj -> unit
override this.WriteStartObject : System.Xml.XmlWriter * obj -> unit
Public Overridable Sub WriteStartObject (writer As XmlWriter, graph As Object)
參數
- graph
- Object
要串連的物件。
- 屬性
例外狀況
被序列化的類型不符合資料合約規則。 例如, DataContractAttribute 屬性尚未套用到型別。
實例被序列化時存在問題。
序列化物件的最大數量已被超越。 檢查 MaxItemsInObjectGraph 屬性。