XmlWriter.WriteStartAttribute Метод

Определение

Записывает начальное значение атрибута при переопределении в производном классе.When overridden in a derived class, writes the start of an attribute.

Перегрузки

WriteStartAttribute(String, String, String)

Когда переопределено в производном классе, записывает начало атрибута с указанным префиксом, локальным именем и URI пространства имен.When overridden in a derived class, writes the start of an attribute with the specified prefix, local name, and namespace URI.

WriteStartAttribute(String)

Записывает начало атрибута с заданным локальным именем.Writes the start of an attribute with the specified local name.

WriteStartAttribute(String, String)

Записывает начало атрибута с заданным локальным именем и URI пространства имен.Writes the start of an attribute with the specified local name and namespace URI.

Комментарии

Асинхронную версию этого метода см. в разделе WriteStartAttributeAsync .For the asynchronous version of this method, see WriteStartAttributeAsync.

WriteStartAttribute(String, String, String)

Когда переопределено в производном классе, записывает начало атрибута с указанным префиксом, локальным именем и URI пространства имен.When overridden in a derived class, writes the start of an attribute with the specified prefix, local name, and namespace 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

Префикс пространства имен атрибута.The namespace prefix of the attribute.

localName
String

Локальное имя атрибута.The local name of the attribute.

ns
String

URI пространства имен атрибута.The namespace URI for the attribute.

Исключения

В буфере присутствует символ, который является допустимым символом XML, но недопустим для кодирования вывода.There is a character in the buffer that is a valid XML character but is not valid for the output encoding. Например, если выходные данные в кодировке ASCII, для имен элементов и атрибутов следует использовать только символы из диапазона от 0 до 127.For example, if the output encoding is ASCII, you should only use characters from the range of 0 to 127 for element and attribute names. Недопустимый символ может быть в аргументе этого метода или в каком-либо аргументе предыдущих методов, которые осуществляли запись в буфер.The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the buffer. Такие знаки экранируются по возможности с помощью ссылок на сущности знаков (например, в текстовых узлах или значениях атрибутов).Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). Однако ссылка на сущность знака не допускается в именах элементов и атрибутов, комментариях, инструкциях по обработке и разделах CDATA.However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections.

Метод XmlWriter вызван перед завершением предыдущей асинхронной операции.An XmlWriter method was called before a previous asynchronous operation finished. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Комментарии

Этот метод позволяет записывать значение с помощью нескольких методов записи.This method enables you to write a value using multiple Write methods.

Асинхронную версию этого метода см. в разделе WriteStartAttributeAsync .For the asynchronous version of this method, see WriteStartAttributeAsync.

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

WriteStartAttribute(String)

Записывает начало атрибута с заданным локальным именем.Writes the start of an attribute with the specified local name.

public:
 void WriteStartAttribute(System::String ^ localName);
public void WriteStartAttribute (string localName);
member this.WriteStartAttribute : string -> unit
Public Sub WriteStartAttribute (localName As String)

Параметры

localName
String

Локальное имя атрибута.The local name of the attribute.

Исключения

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

-или--or-

Метод XmlWriter вызван перед завершением предыдущей асинхронной операции.An XmlWriter method was called before a previous asynchronous operation finished. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

В буфере присутствует символ, который является допустимым символом XML, но недопустим для кодирования вывода.There is a character in the buffer that is a valid XML character but is not valid for the output encoding. Например, если выходные данные в кодировке ASCII, для имен элементов и атрибутов следует использовать только символы из диапазона от 0 до 127.For example, if the output encoding is ASCII, you should only use characters from the range of 0 to 127 for element and attribute names. Недопустимый символ может быть в аргументе этого метода или в каком-либо аргументе предыдущих методов, которые осуществляли запись в буфер.The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the buffer. Такие знаки экранируются по возможности с помощью ссылок на сущности знаков (например, в текстовых узлах или значениях атрибутов).Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). Однако ссылка на сущность знака не допускается в именах элементов и атрибутов, комментариях, инструкциях по обработке и разделах CDATA.However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections.

Комментарии

Этот метод позволяет записывать значение с помощью нескольких методов записи.This method enables you to write a value using multiple Write methods.

Асинхронную версию этого метода см. в разделе WriteStartAttributeAsync .For the asynchronous version of this method, see WriteStartAttributeAsync.

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

WriteStartAttribute(String, String)

Записывает начало атрибута с заданным локальным именем и URI пространства имен.Writes the start of an attribute with the specified local name and namespace 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

Локальное имя атрибута.The local name of the attribute.

ns
String

Универсальный код ресурса (URI) пространства имен атрибута.The namespace URI of the attribute.

Исключения

В буфере присутствует символ, который является допустимым символом XML, но недопустим для кодирования вывода.There is a character in the buffer that is a valid XML character but is not valid for the output encoding. Например, если выходные данные в кодировке ASCII, для имен элементов и атрибутов следует использовать только символы из диапазона от 0 до 127.For example, if the output encoding is ASCII, you should only use characters from the range of 0 to 127 for element and attribute names. Недопустимый символ может быть в аргументе этого метода или в каком-либо аргументе предыдущих методов, которые осуществляли запись в буфер.The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the buffer. Такие знаки экранируются по возможности с помощью ссылок на сущности знаков (например, в текстовых узлах или значениях атрибутов).Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). Однако ссылка на сущность знака не допускается в именах элементов и атрибутов, комментариях, инструкциях по обработке и разделах CDATA.However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections.

Метод XmlWriter вызван перед завершением предыдущей асинхронной операции.An XmlWriter method was called before a previous asynchronous operation finished. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Примеры

XmlTextWriter.WriteStartAttributeПример использования этого метода см. в разделе.See XmlTextWriter.WriteStartAttribute for an example using this method.

Комментарии

Это более сложная версия WriteAttributeString , позволяющая писать значение атрибута с помощью нескольких методов записи, таких как WriteString , WriteQualifiedName и т. д.This is a more advanced version of WriteAttributeString that allows you to write an attribute value using multiple write methods, such as WriteString, WriteQualifiedName, and so on.

Асинхронную версию этого метода см. в разделе WriteStartAttributeAsync .For the asynchronous version of this method, see WriteStartAttributeAsync.

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

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