XmlReader.GetAttribute Метод

Определение

При переопределении в производном классе получает значение атрибута.When overridden in a derived class, gets the value of an attribute.

Перегрузки

GetAttribute(String, String)

При переопределении в производном классе получает значение атрибута с указанными свойствами LocalName и NamespaceURI.When overridden in a derived class, gets the value of the attribute with the specified LocalName and NamespaceURI.

GetAttribute(Int32)

Когда переопределено в производном классе, возвращает значение атрибута по указанному индексу.When overridden in a derived class, gets the value of the attribute with the specified index.

GetAttribute(String)

При переопределении в производном классе получает значение атрибута с указанным свойством Name.When overridden in a derived class, gets the value of the attribute with the specified Name.

GetAttribute(String, String)

При переопределении в производном классе получает значение атрибута с указанными свойствами LocalName и NamespaceURI.When overridden in a derived class, gets the value of the attribute with the specified LocalName and 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

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

namespaceURI
String

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

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

Значение указанного атрибута.The value of the specified attribute. Если атрибут не найден или значение равно String.Empty, возвращается значение null.If the attribute is not found or the value is String.Empty, null is returned. Этот метод не изменяет позицию средства чтения.This method does not move the reader.

Исключения

Свойство name имеет значение null.name is null.

Метод XmlReader вызван перед завершением предыдущей асинхронной операции.An XmlReader 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-код содержит атрибут в определенном пространстве имен:The following XML contains an attribute in a specific namespace:

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

Можно выполнить поиск dt:type атрибута, используя один аргумент (префикс и локальное имя) или два аргумента (локальное имя и URI пространства имен):You can lookup the dt:type attribute using one argument (prefix and local name) or two arguments (local name and namespace URI):

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

Чтобы найти xmlns:dt атрибут, используйте один из следующих аргументов:To lookup the xmlns:dt attribute, use one of the following arguments:

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

Эти сведения также можно получить с помощью свойства Prefix.You can also get this information using the Prefix property.

GetAttribute(Int32)

Когда переопределено в производном классе, возвращает значение атрибута по указанному индексу.When overridden in a derived class, gets the value of the attribute with the specified index.

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

Индекс атрибута.The index of the attribute. Индексация начинается с нуля.The index is zero-based. (Индекс первого атрибута равен нулю.)(The first attribute has index 0.)

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

Значение указанного атрибута.The value of the specified attribute. Этот метод не изменяет позицию средства чтения.This method does not move the reader.

Исключения

i выходит за пределы диапазона.i is out of range. Оно должно быть неотрицательным и меньшим, чем размер коллекции атрибутов.It must be non-negative and less than the size of the attribute collection.

Метод XmlReader вызван перед завершением предыдущей асинхронной операции.An XmlReader 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."

Примеры

В следующем примере возвращается значение третьего атрибута.The following example gets the value of the third attribute.

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

GetAttribute(String)

При переопределении в производном классе получает значение атрибута с указанным свойством Name.When overridden in a derived class, gets the value of the attribute with the specified 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

Полное имя атрибута.The qualified name of the attribute.

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

Значение указанного атрибута.The value of the specified attribute. Если атрибут не найден или значение равно String.Empty, возвращается значение null.If the attribute is not found or the value is String.Empty, null is returned.

Исключения

Свойство name имеет значение null.name is null.

Метод XmlReader вызван перед завершением предыдущей асинхронной операции.An XmlReader 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."

Примеры

В следующем примере возвращается значение атрибута ISBN.The following example gets the value of the ISBN attribute.

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)

Комментарии

Этот метод не изменяет позицию средства чтения.This method does not move the reader.

Если средство чтения находится на DocumentType узле, этот метод можно использовать для получения открытых и СИСТЕМНЫХ литералов, например reader.GetAttribute("PUBLIC")If the reader is positioned on a DocumentType node, this method can be used to get the PUBLIC and SYSTEM literals, for example, reader.GetAttribute("PUBLIC")

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