XmlWriter.WriteStartDocument Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
При переопределении в производном классе записывает объявление XML.
Перегрузки
| Имя | Описание |
|---|---|
| WriteStartDocument(Boolean) |
При переопределении в производном классе записывает объявление XML с версией "1.0" и автономным атрибутом. |
| WriteStartDocument() |
При переопределении в производном классе записывает xml-объявление с версией "1.0". |
Комментарии
Сведения об асинхронной версии этого метода см. в разделе WriteStartDocumentAsync.
WriteStartDocument(Boolean)
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
При переопределении в производном классе записывает объявление XML с версией "1.0" и автономным атрибутом.
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, он записывает "standalone=yes"; if false, он записывает "standalone=no".
Исключения
Это не первый метод записи, который вызывается после конструктора.
–или–
Метод XmlWriter был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".
Комментарии
Уровень кодирования документа определяется тем, как реализуется модуль записи. Например, если Encoding объект указан в конструкторе XmlTextWriter , это определяет значение атрибута кодирования.
При WriteStartDocument вызове модуль записи проверяет, является ли запись хорошо сформированным XML-документом. Например, он проверяет, что объявление XML является первым узлом, существует ли один и только один элемент корневого уровня и т. д. Если этот метод не вызывается, модуль записи предполагает, что фрагмент XML записывается и не применяет правила корневого уровня.
Если WriteStartDocument был вызван, а затем WriteProcessingInstruction метод используется для создания другого xml-объявления, создается исключение.
Сведения об асинхронной версии этого метода см. в разделе WriteStartDocumentAsync.
Применяется к
WriteStartDocument()
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
При переопределении в производном классе записывает xml-объявление с версией "1.0".
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.
