XmlWriter.WriteStartDocument Метод

Определение

Пространство имен:

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Сборка:

System.Xml.dll

Сборка:

netstandard.dll

Когда переопределено в производном классе, записывает объявление XML.

Перегрузки

WriteStartDocument(Boolean)	Когда переопределено в производном классе, записывает объявление XML с номером версии "1.0" и отдельным атрибутом.
WriteStartDocument()	Когда переопределено в производном классе, записывает объявление XML с номером версии "1.0".

Комментарии

Асинхронная версия этого метода см. в разделе WriteStartDocumentAsync.

WriteStartDocument(Boolean)

Когда переопределено в производном классе, записывает объявление XML с номером версии "1.0" и отдельным атрибутом.

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()

Когда переопределено в производном классе, записывает объявление XML с номером версии "1.0".

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.