Freigeben über


XmlReader.GetAttribute Methode

Definition

Ruft beim Überschreiben in einer abgeleiteten Klasse den Wert eines Attributs ab.

Überlädt

GetAttribute(String, String)

Ruft beim Überschreiben in einer abgeleiteten Klasse den Wert des Attributs mit dem angegebenen LocalName und NamespaceURI ab.

GetAttribute(Int32)

Ruft beim Überschreiben in einer abgeleiteten Klasse den Wert des Attributs mit dem angegebenen Index ab.

GetAttribute(String)

Ruft beim Überschreiben in einer abgeleiteten Klasse den Wert des Attributs mit dem angegebenen Name ab.

GetAttribute(String, String)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

Ruft beim Überschreiben in einer abgeleiteten Klasse den Wert des Attributs mit dem angegebenen LocalName und NamespaceURI ab.

public:
 abstract System::String ^ GetAttribute(System::String ^ name, System::String ^ namespaceURI);
public abstract string GetAttribute (string name, 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 dieses Attributs.

Gibt zurück

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

Ausnahmen

name ist null.

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang 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) 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:

GetAttribute(Int32)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

Ruft beim Überschreiben in einer abgeleiteten Klasse den Wert des Attributs mit dem angegebenen Index ab.

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 den Index 0.)

Gibt zurück

Der Wert des angegebenen Attributs. Diese Methode verschiebt den Reader nicht.

Ausnahmen

i liegt außerhalb des Bereichs. Es darf nicht negativ sein und muss kleiner als die Größe der Attributauflistung sein.

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang 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)

Gilt für:

GetAttribute(String)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

Ruft beim Überschreiben in einer abgeleiteten Klasse den Wert des Attributs mit dem angegebenen Name ab.

public:
 abstract System::String ^ GetAttribute(System::String ^ name);
public abstract string GetAttribute (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

Der Wert des angegebenen Attributs. Wenn das Attribut nicht gefunden wird oder Wert String.Empty ist, wird null zurückgegeben.

Ausnahmen

name ist null.

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang 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

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: