Поделиться через


XmlReader.GetAttribute Метод

Определение

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

Перегрузки

GetAttribute(String, String)

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

GetAttribute(Int32)

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

GetAttribute(String)

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

GetAttribute(String, String)

Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs

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

public:
 abstract System::String ^ GetAttribute(System::String ^ name, System::String ^ namespaceURI);
public abstract string GetAttribute (string name, 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.Empty, возвращается значение null. Этот метод не изменяет позицию средства чтения.

Исключения

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

Метод 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
Исходный код:
XmlReader.cs
Исходный код:
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

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

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

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

Исключения

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

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

Примеры

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

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

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

GetAttribute(String)

Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs

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

public:
 abstract System::String ^ GetAttribute(System::String ^ name);
public abstract string GetAttribute (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.Empty, возвращается значение null.

Исключения

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

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

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