XmlWriter.WriteStartAttribute Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
При переопределении в производном классе записывает начало атрибута.
Перегрузки
| Имя | Описание |
|---|---|
| WriteStartAttribute(String, String, String) |
При переопределении в производном классе записывает начало атрибута с указанным префиксом, локальным именем и URI пространства имен. |
| WriteStartAttribute(String) |
Записывает начало атрибута с указанным локальным именем. |
| WriteStartAttribute(String, String) |
Записывает начало атрибута с указанным локальным именем и URI пространства имен. |
Комментарии
Сведения об асинхронной версии этого метода см. в разделе WriteStartAttributeAsync.
WriteStartAttribute(String, String, String)
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
При переопределении в производном классе записывает начало атрибута с указанным префиксом, локальным именем и URI пространства имен.
public:
abstract void WriteStartAttribute(System::String ^ prefix, System::String ^ localName, System::String ^ ns);
public abstract void WriteStartAttribute(string prefix, string localName, string ns);
public abstract void WriteStartAttribute(string? prefix, string localName, string? ns);
abstract member WriteStartAttribute : string * string * string -> unit
Public MustOverride Sub WriteStartAttribute (prefix As String, localName As String, ns As String)
Параметры
- prefix
- String
Префикс пространства имен атрибута.
- localName
- String
Локальное имя атрибута.
- ns
- String
Универсальный код ресурса (URI) пространства имен для атрибута.
Исключения
В буфере есть символ, который является допустимым XML-символом, но не является допустимым для кодирования выходных данных. Например, если кодирование выходных данных равно ASCII, следует использовать только символы из диапазона от 0 до 127 для имен элементов и атрибутов. Недопустимый символ может находиться в аргументе этого метода или в аргументе предыдущих методов, которые записывали в буфер. Такие символы экранируются ссылками на сущности символов, если это возможно (например, в текстовых узлах или значениях атрибутов). Однако ссылка на символьную сущность не допускается в разделах элементов и атрибутов, примечаний, инструкций по обработке или CDATA.
Метод XmlWriter был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".
Комментарии
Этот метод позволяет записывать значение с помощью нескольких методов записи.
Сведения об асинхронной версии этого метода см. в разделе WriteStartAttributeAsync.
Применяется к
WriteStartAttribute(String)
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
Записывает начало атрибута с указанным локальным именем.
public:
void WriteStartAttribute(System::String ^ localName);
public void WriteStartAttribute(string localName);
member this.WriteStartAttribute : string -> unit
Public Sub WriteStartAttribute (localName As String)
Параметры
- localName
- String
Локальное имя атрибута.
Исключения
Модуль записи закрыт.
–или–
Метод XmlWriter был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".
В буфере есть символ, который является допустимым XML-символом, но не является допустимым для кодирования выходных данных. Например, если кодирование выходных данных равно ASCII, следует использовать только символы из диапазона от 0 до 127 для имен элементов и атрибутов. Недопустимый символ может находиться в аргументе этого метода или в аргументе предыдущих методов, которые записывали в буфер. Такие символы экранируются ссылками на сущности символов, если это возможно (например, в текстовых узлах или значениях атрибутов). Однако ссылка на символьную сущность не допускается в разделах элементов и атрибутов, примечаний, инструкций по обработке или CDATA.
Комментарии
Этот метод позволяет записывать значение с помощью нескольких методов записи.
Сведения об асинхронной версии этого метода см. в разделе WriteStartAttributeAsync.
Применяется к
WriteStartAttribute(String, String)
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
Записывает начало атрибута с указанным локальным именем и URI пространства имен.
public:
void WriteStartAttribute(System::String ^ localName, System::String ^ ns);
public void WriteStartAttribute(string localName, string ns);
public void WriteStartAttribute(string localName, string? ns);
member this.WriteStartAttribute : string * string -> unit
Public Sub WriteStartAttribute (localName As String, ns As String)
Параметры
- localName
- String
Локальное имя атрибута.
- ns
- String
URI пространства имен атрибута.
Исключения
В буфере есть символ, который является допустимым XML-символом, но не является допустимым для кодирования выходных данных. Например, если кодирование выходных данных равно ASCII, следует использовать только символы из диапазона от 0 до 127 для имен элементов и атрибутов. Недопустимый символ может находиться в аргументе этого метода или в аргументе предыдущих методов, которые записывали в буфер. Такие символы экранируются ссылками на сущности символов, если это возможно (например, в текстовых узлах или значениях атрибутов). Однако ссылка на символьную сущность не допускается в разделах элементов и атрибутов, примечаний, инструкций по обработке или CDATA.
Метод XmlWriter был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".
Примеры
Пример использования этого метода см XmlTextWriter.WriteStartAttribute . в примере.
Комментарии
Это более расширенная версия, которая позволяет записывать значение атрибута WriteAttributeString с помощью нескольких методов записи, таких как WriteString, WriteQualifiedNameи т. д.
Сведения об асинхронной версии этого метода см. в разделе WriteStartAttributeAsync.