XmlNodeReader.GetAttribute Methode

Referenz

Definition

Namespace:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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)

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

String

Der Wert des angegebenen Attributs.

Ausnahmen

ArgumentOutOfRangeException

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

Hinweise

Hinweis

Im .NET Framework 2.0 empfiehlt es sich, 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)

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()
{
   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

Diese Methode verschiebt den Reader nicht.

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

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 ^ 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

String

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

Hinweise

Hinweis

Die folgende XML 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 Attributs xmlns:dt eine 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.

Gilt für: