XmlWriter.WriteStartAttribute Метод

Определение

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

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Сборка:

System.Xml.dll

Сборка:

netstandard.dll

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

Перегрузки

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 пространства имен атрибута.

Исключения

EncoderFallbackException

В буфере присутствует символ, который является допустимым символом XML, но недопустим для кодирования вывода. Например, если выходные данные в кодировке ASCII, для имен элементов и атрибутов следует использовать только символы из диапазона от 0 до 127. Недопустимый символ может быть в аргументе этого метода или в каком-либо аргументе предыдущих методов, которые осуществляли запись в буфер. Такие знаки экранируются по возможности с помощью ссылок на сущности знаков (например, в текстовых узлах или значениях атрибутов). Однако ссылка на сущность знака не допускается в именах элементов и атрибутов, комментариях, инструкциях по обработке и разделах CDATA.

InvalidOperationException

Метод 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

Локальное имя атрибута.

Исключения

InvalidOperationException

Модуль записи закрыт.

-или-

Метод XmlWriter вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".

EncoderFallbackException

В буфере присутствует символ, который является допустимым символом 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) пространства имен атрибута.

Исключения

EncoderFallbackException

В буфере присутствует символ, который является допустимым символом XML, но недопустим для кодирования вывода. Например, если выходные данные в кодировке ASCII, для имен элементов и атрибутов следует использовать только символы из диапазона от 0 до 127. Недопустимый символ может быть в аргументе этого метода или в каком-либо аргументе предыдущих методов, которые осуществляли запись в буфер. Такие знаки экранируются по возможности с помощью ссылок на сущности знаков (например, в текстовых узлах или значениях атрибутов). Однако ссылка на сущность знака не допускается в именах элементов и атрибутов, комментариях, инструкциях по обработке и разделах CDATA.

InvalidOperationException

Метод XmlWriter вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".

Примеры

Пример использования этого метода см XmlTextWriter.WriteStartAttribute . в примере.

Комментарии

Это более расширенная версия, которая позволяет записывать значение атрибута WriteAttributeString с помощью нескольких методов записи, таких как WriteString, WriteQualifiedNameи т. д.

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

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

• WriteEndAttribute()