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 并显示消息“异步操作已在进行中。”

注解

文档的编码级别由编写器实现方式决定。 例如，如果在构造函数中XmlTextWriter指定对象Encoding，则确定编码特性的值。

调用时 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 并显示消息“异步操作已在进行中。”

注解

文档的编码级别由编写器实现方式决定。 例如，如果在构造函数中XmlTextWriter指定对象Encoding，则确定编码特性的值。 此方法不创建独立属性。

调用编写器时 WriteStartDocument ，验证正在编写的内容是否是格式正确的 XML 文档。 例如，它会检查 XML 声明是否为第一个节点，该节点和只有一个根级元素存在，等等。 如果未调用此方法，编写器假定正在编写 XML 片段，并且不应用根级别规则。

如果 WriteStartDocument 已调用，然后使用 WriteProcessingInstruction 该方法创建另一个 XML 声明，则会引发异常。

有关此方法的异步版本，请参阅 WriteStartDocumentAsync。