XmlReader.GetAttribute Methode

Definition

Namespace:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Wert eines Attributs abgerufen.

Überlädt

Name	Beschreibung
GetAttribute(String, String)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Wert des Attributs mit dem angegebenen und NamespaceURI.LocalName
GetAttribute(Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Wert des Attributs mit dem angegebenen Index abgerufen.
GetAttribute(String)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Wert des Attributs mit der angegebenen Klasse abgerufen Name.

GetAttribute(String, String)

Quelle:

XmlReader.cs

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Wert des Attributs mit dem angegebenen und NamespaceURI.LocalName

public:
 abstract System::String ^ GetAttribute(System::String ^ name, System::String ^ namespaceURI);

public abstract string? GetAttribute(string name, string? namespaceURI);

abstract member GetAttribute : string * string -> string

Public MustOverride Function GetAttribute (name As String, namespaceURI As String) As String

Parameter

name

String

Der lokale Name des Attributs.

namespaceURI

String

Der Namespace-URI des Attributs.

Gibt zurück

String

Der Wert des angegebenen Attributs. Wenn das Attribut nicht gefunden wird oder der Wert String.Emptyist, null wird dieses zurückgegeben. Mit dieser Methode wird der Reader nicht verschoben.

Ausnahmen

ArgumentNullException

name ist null.

InvalidOperationException

Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

Hinweise

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

GetAttribute(Int32)

Quelle:

XmlReader.cs

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Wert des Attributs mit dem angegebenen Index abgerufen.

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

public abstract string GetAttribute(int i);

abstract member GetAttribute : int -> string

Public MustOverride Function GetAttribute (i As Integer) As String

Parameter

i

Int32

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

Gibt zurück

String

Der Wert des angegebenen Attributs. Mit dieser Methode wird der Reader nicht verschoben.

Ausnahmen

ArgumentOutOfRangeException

i liegt außerhalb des zulässigen Bereichs. Er muss nicht negativ und kleiner als die Größe der Attributauflistung sein.

InvalidOperationException

Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

Beispiele

Im folgenden Beispiel wird der Wert des dritten Attributs abgerufen.

reader.ReadToFollowing("book");
string isbn = reader.GetAttribute(2);

reader.ReadToFollowing("book")
Dim isbn As String = reader.GetAttribute(2)

GetAttribute(String)

Quelle:

XmlReader.cs

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Wert des Attributs mit der angegebenen Klasse abgerufen Name.

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

public abstract string? GetAttribute(string name);

abstract member GetAttribute : string -> string

Public MustOverride 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 wird oder der Wert String.Emptyist, null wird dieses zurückgegeben.

Ausnahmen

ArgumentNullException

name ist null.

InvalidOperationException

Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

Beispiele

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

reader.ReadToFollowing("book");
string isbn = reader.GetAttribute("ISBN");
Console.WriteLine("The ISBN value: " + isbn);

reader.ReadToFollowing("book")
Dim isbn As String = reader.GetAttribute("ISBN")
Console.WriteLine("The ISBN value: " + isbn)

Hinweise

Mit dieser Methode wird der Reader nicht verschoben.

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")