Freigeben über


XmlNodeReader.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.

GetAttribute(Int32)

Quelle:
XmlNodeReader.cs
Quelle:
XmlNodeReader.cs
Quelle:
XmlNodeReader.cs

Ruft den Wert des Attributs mit dem angegebenen Index ab.

public:
 override System::String ^ GetAttribute(int attributeIndex);
public override string GetAttribute (int attributeIndex);
override this.GetAttribute : int -> string
Public Overrides Function GetAttribute (attributeIndex As Integer) As String

Parameter

attributeIndex
Int32

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

Gibt zurück

Der Wert des angegebenen Attributs.

Ausnahmen

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

Hinweise

Hinweis

Im .NET Framework 2.0 wird empfohlen, Instanzen mithilfe der XmlReaderSettings -Klasse und der Create -Methode zu erstellenXmlReader. Dadurch können Sie alle neuen Features nutzen, die im .NET Framework eingeführt wurden. Weitere Informationen finden Sie im Abschnitt Hinweise auf der XmlReader Referenzseite.

Diese Methode verschiebt den Reader nicht.

Gilt für:

GetAttribute(String)

Quelle:
XmlNodeReader.cs
Quelle:
XmlNodeReader.cs
Quelle:
XmlNodeReader.cs

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

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()
{
   XmlNodeReader^ reader = nullptr;
   try
   {
      
      //Create and load the XML document.
      XmlDocument^ doc = gcnew XmlDocument;
      doc->LoadXml( "<book genre='novel' ISBN='1-861003-78' publicationdate='1987'> "
      "</book>" );
      
      // Load the XmlNodeReader 
      reader = gcnew XmlNodeReader( doc );
      
      //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()
  {
    XmlNodeReader reader = null;

    try
    {
       //Create and load the XML document.
       XmlDocument doc = new XmlDocument();
       doc.LoadXml("<book genre='novel' ISBN='1-861003-78' publicationdate='1987'> " +
                   "</book>");

       // Load the XmlNodeReader
       reader = new XmlNodeReader(doc);

       //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 XmlNodeReader = Nothing
        
        Try
            'Create and load the XML document.
            Dim doc As New XmlDocument()
            doc.LoadXml("<book genre='novel' ISBN='1-861003-78' publicationdate='1987'> " & _
                       "</book>")
            
            ' Load the XmlNodeReader 
            reader = New XmlNodeReader(doc)
            
            '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

Hinweise

Hinweis

Im .NET Framework 2.0 wird empfohlen, Instanzen mithilfe der XmlReaderSettings -Klasse und der Create -Methode zu erstellenXmlReader. Dadurch können Sie alle neuen Features nutzen, die im .NET Framework eingeführt wurden. Weitere Informationen finden Sie im Abschnitt Hinweise auf der XmlReader Referenzseite.

Diese Methode verschiebt den Reader nicht.

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

Gilt für:

GetAttribute(String, String)

Quelle:
XmlNodeReader.cs
Quelle:
XmlNodeReader.cs
Quelle:
XmlNodeReader.cs

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

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

Parameter

name
String

Der lokale Name des Attributs.

namespaceURI
String

Der Namespace-URI dieses Attributs.

Gibt zurück

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

Hinweise

Hinweis

Im .NET Framework 2.0 wird empfohlen, Instanzen mithilfe der XmlReaderSettings -Klasse und der Create -Methode zu erstellenXmlReader. Dadurch können Sie alle neuen Features nutzen, die im .NET Framework eingeführt wurden. Weitere Informationen finden Sie im Abschnitt Hinweise auf der XmlReader Referenzseite.

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 mit einem Argument (Präfix und lokalem Namen) oder zwei Argumenten (lokaler Name und Namespace-URI) suchen:

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

Verwenden Sie eines der folgenden Argumente, um das xmlns:dt Attribut zu suchen:

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.

Gilt für: