XmlReader.GetAttribute Метод

Определение

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

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

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

Перегрузки

GetAttribute(String, String)	При переопределении в производном классе получает значение атрибута с указанными свойствами LocalName и NamespaceURI.
GetAttribute(Int32)	Когда переопределено в производном классе, возвращает значение атрибута по указанному индексу.
GetAttribute(String)	При переопределении в производном классе получает значение атрибута с указанным свойством Name.

GetAttribute(String, String)

Исходный код:

XmlReader.cs

При переопределении в производном классе получает значение атрибута с указанными свойствами LocalName и NamespaceURI.

public:
 abstract System::String ^ GetAttribute(System::String ^ name, System::String ^ namespaceURI);

public abstract string? GetAttribute (string name, string? namespaceURI);

abstract member GetAttribute : string * string -> string

Public MustOverride Function GetAttribute (name As String, namespaceURI As String) As String

Параметры

name

String

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

namespaceURI

String

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

Возвращаемое значение

String

Значение указанного атрибута. Если атрибут не найден или значение равно String.Empty, возвращается значение null. Этот метод не изменяет позицию средства чтения.

Исключения

ArgumentNullException

name имеет значение null.

InvalidOperationException

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

Комментарии

Следующий XML-код содержит атрибут в определенном пространстве имен:

<test xmlns:dt="urn:datatypes" dt:type="int"/>

Атрибут можно найти dt:type с помощью одного аргумента (префикс и локальное имя) или двух аргументов (локальное имя и URI пространства имен):

String dt = reader.GetAttribute("dt:type");
String dt2 = reader.GetAttribute("type","urn:datatypes");

Чтобы найти xmlns:dt атрибут, используйте один из следующих аргументов:

String dt3 = reader.GetAttribute("xmlns:dt");
String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);

Эти сведения также можно получить с помощью Prefix свойства .

GetAttribute(Int32)

Исходный код:

XmlReader.cs

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

public:
 abstract System::String ^ GetAttribute(int i);

public abstract string GetAttribute (int i);

abstract member GetAttribute : int -> string

Public MustOverride Function GetAttribute (i As Integer) As String

Параметры

i

Int32

Индекс атрибута. Индексация начинается с нуля. (Индекс первого атрибута равен нулю.)

Возвращаемое значение

String

Значение указанного атрибута. Этот метод не изменяет позицию средства чтения.

Исключения

ArgumentOutOfRangeException

i выходит за пределы диапазона. Оно должно быть неотрицательным и меньшим, чем размер коллекции атрибутов.

InvalidOperationException

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

Примеры

В следующем примере возвращается значение третьего атрибута.

reader.ReadToFollowing("book");
string isbn = reader.GetAttribute(2);

reader.ReadToFollowing("book")
Dim isbn As String = reader.GetAttribute(2)

GetAttribute(String)

Исходный код:

XmlReader.cs

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

public:
 abstract System::String ^ GetAttribute(System::String ^ name);

public abstract string? GetAttribute (string name);

abstract member GetAttribute : string -> string

Public MustOverride Function GetAttribute (name As String) As String

Параметры

name

String

Полное имя атрибута.

Возвращаемое значение

String

Значение указанного атрибута. Если атрибут не найден или значение равно String.Empty, возвращается значение null.

Исключения

ArgumentNullException

name имеет значение null.

InvalidOperationException

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

Примеры

В следующем примере возвращается значение атрибута ISBN.

reader.ReadToFollowing("book");
string isbn = reader.GetAttribute("ISBN");
Console.WriteLine("The ISBN value: " + isbn);

reader.ReadToFollowing("book")
Dim isbn As String = reader.GetAttribute("ISBN")
Console.WriteLine("The ISBN value: " + isbn)

Комментарии

Этот метод не изменяет позицию средства чтения.

Если средство чтения расположено на DocumentType узле, этот метод можно использовать для получения литералов PUBLIC и SYSTEM, например: reader.GetAttribute("PUBLIC")