XmlTextReader.GetAttribute Метод

Определение

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

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Возвращает значение атрибута.

Перегрузки

GetAttribute(Int32)	Возвращает значение атрибута по заданному индексу.
GetAttribute(String)	Возвращает значение атрибута с указанным именем.
GetAttribute(String, String)	Возвращает значение атрибута с указанным локальным именем и универсальным кодом ресурса (URI) пространства имен.

Комментарии

Примечание

Начиная с платформа .NET Framework 2.0 рекомендуется создавать XmlReader экземпляры с помощью XmlReader.Create метода , чтобы воспользоваться преимуществами новых функций.

GetAttribute(Int32)

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

XmlTextReader.cs

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

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

public override string GetAttribute (int i);

override this.GetAttribute : int -> string

Public Overrides Function GetAttribute (i As Integer) As String

Параметры

i

Int32

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

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

String

Значение указанного атрибута.

Исключения

ArgumentOutOfRangeException

Параметр i меньше 0 или больше или равен AttributeCount.

Комментарии

Примечание

Начиная с платформа .NET Framework 2.0 рекомендуется создавать XmlReader экземпляры с помощью XmlReader.Create метода , чтобы воспользоваться преимуществами новых функций.

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

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

• XmlReader

GetAttribute(String)

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

XmlTextReader.cs

Возвращает значение атрибута с указанным именем.

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

public override string? GetAttribute (string name);

override this.GetAttribute : string -> string

Public Overrides Function GetAttribute (name As String) As String

Параметры

name

String

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

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

String

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

Примеры

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

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlTextReader^ reader = nullptr;
   try
   {
      
      //Load the reader with the XML file.
      reader = gcnew XmlTextReader( "attrs.xml" );
      
      //Read the ISBN attribute.
      reader->MoveToContent();
      String^ isbn = reader->GetAttribute( "ISBN" );
      Console::WriteLine( "The ISBN value: {0}", isbn );
   }
   finally
   {
      if ( reader != nullptr )
            reader->Close();
   }

}

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    XmlTextReader reader = null;

    try
    {
       //Load the reader with the XML file.
       reader = new XmlTextReader("attrs.xml");

       //Read the ISBN attribute.
       reader.MoveToContent();
       string isbn = reader.GetAttribute("ISBN");
       Console.WriteLine("The ISBN value: " + isbn);
     }
     finally
     {
        if (reader != null)
          reader.Close();
      }
  }
} // End class

Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        Dim reader As XmlTextReader = Nothing
        
        Try
            'Load the reader with the XML file.
            reader = New XmlTextReader("attrs.xml")
            
            'Read the ISBN attribute.
            reader.MoveToContent()
            Dim isbn As String = reader.GetAttribute("ISBN")
            Console.WriteLine("The ISBN value: " & isbn)
        
        Finally
            If Not (reader Is Nothing) Then
                reader.Close()
            End If
        End Try
    End Sub
End Class

В этом примере в качестве входных данных используется файл attrs.xml.

<book genre='novel' ISBN='1-861003-78' pubdate='1987'>
</book>

Комментарии

Примечание

Начиная с платформа .NET Framework 2.0 рекомендуется создавать XmlReader экземпляры с помощью XmlReader.Create метода , чтобы воспользоваться преимуществами новых функций.

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

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

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

• XmlReader

GetAttribute(String, String)

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

XmlTextReader.cs

Возвращает значение атрибута с указанным локальным именем и универсальным кодом ресурса (URI) пространства имен.

public:
 override System::String ^ GetAttribute(System::String ^ localName, System::String ^ namespaceURI);

public override string? GetAttribute (string localName, string? namespaceURI);

override this.GetAttribute : string * string -> string

Public Overrides Function GetAttribute (localName As String, namespaceURI As String) As String

Параметры

localName

String

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

namespaceURI

String

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

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

String

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

Комментарии

Примечание

Начиная с платформа .NET Framework 2.0 рекомендуется создавать XmlReader экземпляры с помощью XmlReader.Create метода , чтобы воспользоваться преимуществами новых функций.

Следующий 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 свойства .

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

• XmlReader