共用方式為


XmlWriter.WriteStartDocument 方法

定義

在衍生類別中覆寫時,寫入 XML 宣告。

多載

WriteStartDocument(Boolean)

在衍生類別中覆寫時,使用「1.0」版寫入 XML 宣告與獨立屬性。

WriteStartDocument()

在衍生類別中覆寫時,使用「1.0」版寫入 XML 宣告。

備註

如需這個方法的非同步版本,請參閱 WriteStartDocumentAsync

WriteStartDocument(Boolean)

在衍生類別中覆寫時,使用「1.0」版寫入 XML 宣告與獨立屬性。

public:
 abstract void WriteStartDocument(bool standalone);
public abstract void WriteStartDocument (bool standalone);
abstract member WriteStartDocument : bool -> unit
Public MustOverride Sub WriteStartDocument (standalone As Boolean)

參數

standalone
Boolean

如果 true,它會寫入「standalone=yes」;如果 false,它會寫入「standalone=no」。

例外狀況

這不是在建構函式之後呼叫的第一個寫入方法。

-或-

在先前的非同步作業完成前呼叫了 XmlWriter 方法。 在此情況下,會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

備註

檔的編碼層級取決於寫入器的實作方式。 例如,如果在建 Encoding 構函式中 XmlTextWriter 指定物件,這會決定編碼屬性的值。

呼叫 時 WriteStartDocument ,寫入器會驗證您正在撰寫的內容是格式正確的 XML 檔。 例如,它會檢查 XML 宣告是否為第一個節點、其中一個和只有一個根層級元素存在,依此類故。 如果未呼叫這個方法,寫入器會假設正在寫入 XML 片段,而且不會套用根層級規則。

如果 WriteStartDocument 已呼叫 ,然後使用 WriteProcessingInstruction 方法來建立另一個 XML 宣告,則會擲回例外狀況。

如需這個方法的非同步版本,請參閱 WriteStartDocumentAsync

適用於

WriteStartDocument()

在衍生類別中覆寫時,使用「1.0」版寫入 XML 宣告。

public:
 abstract void WriteStartDocument();
public abstract void WriteStartDocument ();
abstract member WriteStartDocument : unit -> unit
Public MustOverride Sub WriteStartDocument ()

例外狀況

這不是在建構函式之後呼叫的第一個寫入方法。

-或-

在先前的非同步作業完成前呼叫了 XmlWriter 方法。 在此情況下,會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

備註

檔的編碼層級取決於寫入器實作方式。 例如,如果在 Encoding 建構函式中 XmlTextWriter 指定物件,這會決定編碼屬性的值。 這個方法不會建立獨立屬性。

呼叫 時 WriteStartDocument ,寫入器會驗證您撰寫的內容是格式正確的 XML 檔。 例如,它會檢查 XML 宣告是第一個節點,其中一個和只有一個根層級元素存在,依此類故。 如果未呼叫此方法,寫入器會假設正在寫入 XML 片段,而且不會套用根層級規則。

如果 WriteStartDocument 已呼叫 ,然後使用 WriteProcessingInstruction 方法來建立另一個 XML 宣告,將會擲回例外狀況。

如需這個方法的非同步版本,請參閱 WriteStartDocumentAsync

適用於