XmlReader.GetAttribute Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Ha felül van bírálva egy származtatott osztályban, lekéri egy attribútum értékét.

Túlterhelések

Név	Description
GetAttribute(String, String)	Ha felül van bírálva egy származtatott osztályban, lekéri az attribútum értékét a megadott LocalName és NamespaceURIa .
GetAttribute(Int32)	Ha felülbírált egy származtatott osztályban, lekéri az attribútum értékét a megadott indexszel.
GetAttribute(String)	Ha felül van bírálva egy származtatott osztályban, lekéri az attribútum értékét a megadott Nameértékkel.

GetAttribute(String, String)

Forrás:

XmlReader.cs

Ha felül van bírálva egy származtatott osztályban, lekéri az attribútum értékét a megadott LocalName és NamespaceURIa .

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

Paraméterek

name

String

Az attribútum helyi neve.

namespaceURI

String

Az attribútum névterének URI-ja.

Válaszok

String

A megadott attribútum értéke. Ha az attribútum nem található, null a rendszer visszaadja. Ez a metódus nem helyezi át az olvasót.

Kivételek

ArgumentNullException

name az null.

InvalidOperationException

Egy XmlReader metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

Megjegyzések

A következő XML egy attribútumot tartalmaz egy adott névtérben:

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

Az attribútumot egy argumentum (előtag és helyi név) vagy két argumentum (helyi név és névtér URI) használatával keresheti dt:type meg:

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

Az xmlns:dt attribútum kereséséhez használja az alábbi argumentumok egyikét:

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

Ezeket az információkat a Prefix tulajdonság használatával is lekérheti.

GetAttribute(Int32)

Forrás:

XmlReader.cs

Ha felülbírált egy származtatott osztályban, lekéri az attribútum értékét a megadott indexszel.

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

Paraméterek

i

Int32

Az attribútum indexe. Az index nulla alapú. (Az első attribútum indexe 0.)

Válaszok

String

A megadott attribútum értéke. Ez a metódus nem helyezi át az olvasót.

Kivételek

ArgumentOutOfRangeException

i tartományon kívül esik. Nem negatívnak és az attribútumgyűjtemény méreténél kisebbnek kell lennie.

InvalidOperationException

Egy XmlReader metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

Példák

Az alábbi példa a harmadik attribútum értékét adja meg.

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

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

GetAttribute(String)

Forrás:

XmlReader.cs

Ha felül van bírálva egy származtatott osztályban, lekéri az attribútum értékét a megadott Nameértékkel.

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

Paraméterek

name

String

Az attribútum minősített neve.

Válaszok

String

A megadott attribútum értéke. Ha az attribútum nem található, null a rendszer visszaadja. Ha az attribútum jelen van, de üres értékkel rendelkezik, Empty akkor a függvény visszaadja.

Kivételek

ArgumentNullException

name az null.

InvalidOperationException

Egy XmlReader metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

Példák

Az alábbi példa beolvasja az ISBN attribútum értékét.

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)

Megjegyzések

Ez a metódus nem helyezi át az olvasót.

Ha az olvasó egy DocumentType csomóponton van elhelyezve, ez a módszer használható a NYILVÁNOS és a SYSTEM literálok lekérésére, például: reader.GetAttribute("PUBLIC")