XmlTextReader.GetAttribute Methode

Definition

Ruft den Wert eines Attributs ab.

Überlädt

GetAttribute(Int32)

Ruft den Wert des Attributs mit dem angegebenen Index ab.

GetAttribute(String)

Ruft den Wert des Attributs mit dem angegebenen Namen ab.

GetAttribute(String, String)

Ruft den Wert des Attributs mit dem angegebenen lokalen Namen und Namespace-URI ab.

Hinweise

Hinweis

Ab dem .NET Framework 2.0 empfehlen wir, Instanzen mithilfe der XmlReader.Create Methode zu erstellenXmlReader, um neue Funktionen zu nutzen.

GetAttribute(Int32)

Ruft den Wert des Attributs mit dem angegebenen Index ab.

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

Parameter

i
Int32

Der Index des Attributs. Der Index ist nullbasiert. (Das erste Attribut hat den Index 0.)

Gibt zurück

String

Der Wert des angegebenen Attributs.

Ausnahmen

Der i-Parameter ist kleiner als 0 (null) oder größer als oder gleich AttributeCount.

Hinweise

Hinweis

Ab dem .NET Framework 2.0 empfehlen wir, Instanzen mithilfe der XmlReader.Create Methode zu erstellenXmlReader, um neue Funktionen zu nutzen.

Diese Methode verschiebt den Reader nicht.

Siehe auch

Gilt für

GetAttribute(String)

Ruft den Wert des Attributs mit dem angegebenen Namen ab.

public:
 override System::String ^ GetAttribute(System::String ^ name);
public override string? GetAttribute (string name);
public override string GetAttribute (string name);
override this.GetAttribute : string -> string
Public Overrides Function GetAttribute (name As String) As String

Parameter

name
String

Der qualifizierte Name des Attributs.

Gibt zurück

String

Der Wert des angegebenen Attributs. Wenn das Attribut nicht gefunden wurde, wird null zurückgegeben.

Beispiele

Im folgenden Beispiel wird der Wert des ISBN-Attributs abgerufen.

#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

Im Beispiel wird die Datei als attrs.xmlEingabe verwendet.


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

Hinweise

Hinweis

Ab dem .NET Framework 2.0 empfehlen wir, Instanzen mithilfe der XmlReader.Create Methode zu erstellenXmlReader, um neue Funktionen zu nutzen.

Diese Methode verschiebt den Reader nicht.

Wenn der Leser auf einem DocumentType Knoten positioniert ist, kann diese Methode verwendet werden, um z. B. die Literale PUBLIC und SYSTEM abzurufen. reader.GetAttribute("PUBLIC")

Siehe auch

Gilt für

GetAttribute(String, String)

Ruft den Wert des Attributs mit dem angegebenen lokalen Namen und Namespace-URI ab.

public:
 override System::String ^ GetAttribute(System::String ^ localName, System::String ^ namespaceURI);
public override string? GetAttribute (string localName, 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

Parameter

localName
String

Der lokale Name des Attributs.

namespaceURI
String

Der Namespace-URI dieses Attributs.

Gibt zurück

String

Der Wert des angegebenen Attributs. Wenn das Attribut nicht gefunden wurde, wird null zurückgegeben. Diese Methode verschiebt den Reader nicht.

Hinweise

Hinweis

Ab dem .NET Framework 2.0 empfehlen wir, Instanzen mithilfe der XmlReader.Create Methode zu erstellenXmlReader, um neue Funktionen zu nutzen.

Der folgende XML-Code enthält ein Attribut in einem bestimmten Namespace:

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

Sie können das dt:type Attribut mithilfe eines Arguments (Präfix und lokaler Name) oder zwei Argumente (lokaler Name und Namespace-URI) nachschlagen:

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

Verwenden Sie zum Nachschlagen des xmlns:dt Attributs eines der folgenden Argumente:

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

Sie können diese Informationen auch mithilfe der Prefix Eigenschaft abrufen.

Siehe auch

Gilt für