XmlReader.GetAttribute Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Po zastąpieniu w klasie pochodnej pobiera wartość atrybutu.

Przeciążenia

GetAttribute(String, String)	Po zastąpieniu w klasie pochodnej pobiera wartość atrybutu o określonej wartości LocalName i NamespaceURI.
GetAttribute(Int32)	Po zastąpieniu w klasie pochodnej pobiera wartość atrybutu z określonym indeksem.
GetAttribute(String)	Po zastąpieniu w klasie pochodnej pobiera wartość atrybutu o określonej wartości Name.

GetAttribute(String, String)

Po zastąpieniu w klasie pochodnej pobiera wartość atrybutu o określonej wartości LocalName i 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

Lokalna nazwa atrybutu.

namespaceURI

String

Identyfikator URI przestrzeni nazw atrybutu.

Zwraca

String

Wartość określonego atrybutu. Jeśli atrybut nie zostanie znaleziony lub zostanie zwrócona wartość String.Empty, null zostanie zwrócona. Ta metoda nie przenosi czytnika.

Wyjątki

ArgumentNullException

name to null.

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Uwagi

Następujący kod XML zawiera atrybut w określonej przestrzeni nazw:

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

Atrybut można wyszukać przy użyciu jednego argumentu dt:type (prefiksu i nazwy lokalnej) lub dwóch argumentów (nazwa lokalna i identyfikator URI przestrzeni nazw):

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

Aby wyszukać xmlns:dt atrybut, użyj jednego z następujących argumentów:

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

Te informacje można również uzyskać przy użyciu Prefix właściwości .

GetAttribute(Int32)

Po zastąpieniu w klasie pochodnej pobiera wartość atrybutu z określonym indeksem.

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

Indeks atrybutu. Jest to indeks zaczynający się od zera. (Pierwszy atrybut ma indeks 0).

Zwraca

String

Wartość określonego atrybutu. Ta metoda nie przenosi czytnika.

Wyjątki

ArgumentOutOfRangeException

i jest poza zakresem. Musi być nie ujemna i mniejsza niż rozmiar kolekcji atrybutów.

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Przykłady

Poniższy przykład pobiera wartość trzeciego atrybutu.

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

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

GetAttribute(String)

Po zastąpieniu w klasie pochodnej pobiera wartość atrybutu o określonej wartości 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

Kwalifikowana nazwa atrybutu.

Zwraca

String

Wartość określonego atrybutu. Jeśli atrybut nie zostanie znaleziony lub zostanie zwrócona wartość String.Empty, null zostanie zwrócona.

Wyjątki

ArgumentNullException

name to null.

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Przykłady

Poniższy przykład pobiera wartość atrybutu 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)

Uwagi

Ta metoda nie przenosi czytnika.

Jeśli czytnik jest umieszczony w węźle DocumentType , ta metoda może służyć do pobierania literałów PUBLIC i SYSTEM, na przykład, reader.GetAttribute("PUBLIC")