XmlWriter.WriteStartDocument 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
當在衍生類別中覆寫時，會寫入 XML 宣告。
多載
| 名稱 | Description |
|---|---|
| WriteStartDocument(Boolean) |
當在派生類別中覆寫時，會寫入帶有版本「1.0」及獨立屬性的 XML 宣告。 |
| WriteStartDocument() |
當在衍生類別中覆寫時，會以版本「1.0」寫入 XML 宣告。 |
備註
關於此方法的非同步版本，請參見 WriteStartDocumentAsync。
WriteStartDocument(Boolean)
- 來源:
- XmlWriter.cs
- 來源:
- XmlWriter.cs
- 來源:
- XmlWriter.cs
- 來源:
- XmlWriter.cs
- 來源:
- XmlWriter.cs
當在派生類別中覆寫時，會寫入帶有版本「1.0」及獨立屬性的 XML 宣告。
public:
abstract void WriteStartDocument(bool standalone);public abstract void WriteStartDocument(bool standalone);abstract member WriteStartDocument : bool -> unitPublic MustOverride Sub WriteStartDocument (standalone As Boolean)參數
- standalone
- Boolean
若 true，則寫為「獨立=是」;若 false，則寫為「獨立=否」。
例外狀況
這不是建構子之後第一個被呼叫的寫入方法。
-或-
在先前非同步操作結束前，會呼叫一個 XmlWriter 方法。 此時， InvalidOperationException 會拋出「非同步操作已進行中」的訊息。
備註
文件的編碼層級由撰寫者實作方式決定。 例如，若建構子中指定Encoding物件XmlTextWriter，則決定編碼屬性的值。
當 WriteStartDocument 被呼叫時，寫者會驗證你所撰寫的內容是否為格式良好的 XML 文件。 例如，它會檢查 XML 宣告是否為第一個節點，且僅有一個根層級元素存在，依此類推。 若未呼叫此方法，寫入者會假設正在撰寫 XML 片段，並未套用根層規則。
如果 WriteStartDocument 已經被呼叫，然後 WriteProcessingInstruction 該方法被用來建立另一個 XML 宣告，則會拋出例外。
關於此方法的非同步版本，請參見 WriteStartDocumentAsync。
適用於
WriteStartDocument()
- 來源:
- XmlWriter.cs
- 來源:
- XmlWriter.cs
- 來源:
- XmlWriter.cs
- 來源:
- XmlWriter.cs
- 來源:
- XmlWriter.cs
當在衍生類別中覆寫時，會以版本「1.0」寫入 XML 宣告。
public:
abstract void WriteStartDocument();public abstract void WriteStartDocument();abstract member WriteStartDocument : unit -> unitPublic MustOverride Sub WriteStartDocument ()例外狀況
這不是建構子之後第一個被呼叫的寫入方法。
-或-
在先前非同步操作結束前，會呼叫一個 XmlWriter 方法。 此時， InvalidOperationException 會拋出「非同步操作已進行中」的訊息。
備註
文件的編碼層級由撰寫者實作方式決定。 例如，若建構子中指定Encoding物件XmlTextWriter，則決定編碼屬性的值。 此方法不會建立獨立屬性。
當 WriteStartDocument 被呼叫時，寫手會驗證你所撰寫的內容是否結構良好的 XML 文件。 例如，它會檢查 XML 宣告是否為第一個節點，且僅有一個根層級元素存在，依此類推。 若未呼叫此方法，寫入者會假設正在撰寫 XML 片段，並未套用根層規則。
如果 WriteStartDocument 已經被呼叫，然後 WriteProcessingInstruction 該方法被用來建立另一個 XML 宣告，則會拋出例外。
關於此方法的非同步版本，請參見 WriteStartDocumentAsync。
