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.

См. также раздел

Применяется к