XmlReader.GetAttribute Metoda

  • Reference

Definice

Obor názvů:
System.Xml
Sestavení:
System.Xml.ReaderWriter.dll
Sestavení:
System.Xml.dll
Sestavení:
netstandard.dll

Při přepsání v odvozené třídě získá hodnotu atributu.

Přetížení

GetAttribute(String, String)

Při přepsání v odvozené třídě získá hodnotu atributu se zadaným LocalName a NamespaceURI.
GetAttribute(Int32)

Při přepsání v odvozené třídě získá hodnotu atributu se zadaným indexem.
GetAttribute(String)

Při přepsání v odvozené třídě získá hodnotu atributu se zadaným Name.

GetAttribute(String, String)

Při přepsání v odvozené třídě získá hodnotu atributu se zadaným LocalName a NamespaceURI.

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

Parametry

name
String

Místní název atributu.

namespaceURI
String

Identifikátor URI oboru názvů atributu.

Návraty

String

Hodnota zadaného atributu. Pokud atribut nebyl nalezen nebo hodnota je String.Emptyvrácena null . Tato metoda nepřesune čtenáře.

Výjimky

ArgumentNullException

name je null.

InvalidOperationException

XmlReader Metoda byla volána před dokončením předchozí asynchronní operace. V tomto případě InvalidOperationException se vyvolá zpráva "Asynchronní operace už probíhá".

Poznámky

Následující XML obsahuje atribut v určitém oboru názvů:

<test xmlns:dt="urn:datatypes" dt:type="int"/>

Atribut můžete vyhledat pomocí jednoho argumentu dt:type (předpony a místního názvu) nebo dvou argumentů (místní název a identifikátor URI oboru názvů):

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

Pokud chcete vyhledat xmlns:dt atribut, použijte jeden z následujících argumentů:

String dt3 = reader.GetAttribute("xmlns:dt");
String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);

Tyto informace můžete získat také pomocí Prefix vlastnosti.

Platí pro

GetAttribute(Int32)

Při přepsání v odvozené třídě získá hodnotu atributu se zadaným indexem.

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

Parametry

i
Int32

Index atributu. Index je založený na nule. (První atribut má index 0.)

Návraty

String

Hodnota zadaného atributu. Tato metoda nepřesune čtenáře.

Výjimky

ArgumentOutOfRangeException

i je mimo rozsah. Musí být nezáporná a menší než velikost kolekce atributů.

InvalidOperationException

XmlReader Metoda byla volána před dokončením předchozí asynchronní operace. V tomto případě InvalidOperationException se vyvolá zpráva "Asynchronní operace už probíhá".

Příklady

Následující příklad získá hodnotu třetího atributu.

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

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

Platí pro

GetAttribute(String)

Při přepsání v odvozené třídě získá hodnotu atributu se zadaným Name.

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

Parametry

name
String

Kvalifikovaný název atributu.

Návraty

String

Hodnota zadaného atributu. Pokud atribut nebyl nalezen nebo hodnota je String.Emptyvrácena null .

Výjimky

ArgumentNullException

name je null.

InvalidOperationException

XmlReader Metoda byla volána před dokončením předchozí asynchronní operace. V tomto případě InvalidOperationException se vyvolá zpráva "Asynchronní operace už probíhá".

Příklady

Následující příklad získá hodnotu atributu ISBN.

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)

Poznámky

Tato metoda nepřesune čtenáře.

Pokud je čtečka umístěna na DocumentType uzlu, lze tuto metodu použít k získání veřejných a systémových literálů, například reader.GetAttribute("PUBLIC")

Platí pro