Бөлісу құралы:


XmlWriter.WriteStartAttribute Метод

Определение

Записывает начальное значение атрибута при переопределении в производном классе.

Перегрузки

WriteStartAttribute(String, String, String)

Когда переопределено в производном классе, записывает начало атрибута с указанным префиксом, локальным именем и URI пространства имен.

WriteStartAttribute(String)

Записывает начало атрибута с заданным локальным именем.

WriteStartAttribute(String, String)

Записывает начало атрибута с заданным локальным именем и URI пространства имен.

Комментарии

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

WriteStartAttribute(String, String, String)

Когда переопределено в производном классе, записывает начало атрибута с указанным префиксом, локальным именем и 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)

Записывает начало атрибута с заданным локальным именем.

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)

Записывает начало атрибута с заданным локальным именем и 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.

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

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