XmlTextReader.GetAttribute Methode
Definition
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. |
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
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
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.xml
Eingabe 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
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.