XmlWriter.WriteStartDocument 方法

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

組件:

System.Xml.dll

組件:

netstandard.dll

在衍生類別中覆寫時，寫入 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」。

例外狀況

InvalidOperationException

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

-或-

在先前的非同步作業完成前呼叫了 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 ()

例外狀況

InvalidOperationException

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

-或-

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

備註

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

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

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

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