XmlReader.GetAttribute Метод

Определение

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

System.Xml

Сборки:

netstandard.dll, 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

Индекс атрибута. Значения индекса начинаются с нуля. (Первый атрибут имеет индекс 0.)

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

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")