XmlReader.GetAttribute Metod

Definition

Namnområde:
System.Xml
Sammansättningar:
System.Xml.dll, System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.dll
Sammansättning:
System.Xml.ReaderWriter.dll
Sammansättning:
netstandard.dll

När det åsidosättas i en härledd klass hämtar värdet för ett attribut.

Överlagringar

Name Description
GetAttribute(String, String)

När det åsidosättas i en härledd klass hämtar värdet för attributet med angivet LocalName och NamespaceURI.
GetAttribute(Int32)

När det åsidosättas i en härledd klass hämtar du värdet för attributet med det angivna indexet.
GetAttribute(String)

När det åsidosättas i en härledd klass hämtar värdet för attributet med den angivna Name.

GetAttribute(String, String)

När det åsidosättas i en härledd klass hämtar värdet för attributet med angivet LocalName och NamespaceURI.

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

Parametrar

name
String

Attributets lokala namn.

namespaceURI
String

Attributets namnområdes-URI.

Returer

String

Värdet för det angivna attributet. Om attributet inte hittas eller om värdet är String.Empty, null returneras. Den här metoden flyttar inte läsaren.

Undantag

ArgumentNullException

name är null.

InvalidOperationException

En XmlReader metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".

Kommentarer

Följande XML innehåller ett attribut i ett specifikt namnområde:

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

Du kan leta upp dt:type attributet med ett argument (prefix och lokalt namn) eller två argument (lokalt namn och namnområdes-URI):

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

Om du vill söka efter xmlns:dt attributet använder du något av följande argument:

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

Du kan också hämta den här informationen med hjälp av Prefix egenskapen .

Gäller för

GetAttribute(Int32)

När det åsidosättas i en härledd klass hämtar du värdet för attributet med det angivna indexet.

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

Parametrar

i
Int32

Attributets index. Indexet är nollbaserat. (Det första attributet har index 0.)

Returer

String

Värdet för det angivna attributet. Den här metoden flyttar inte läsaren.

Undantag

ArgumentOutOfRangeException

i är utom räckhåll. Den måste vara icke-negativ och mindre än storleken på attributsamlingen.

InvalidOperationException

En XmlReader metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".

Exempel

I följande exempel hämtas värdet för det tredje attributet.

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

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

Gäller för

GetAttribute(String)

När det åsidosättas i en härledd klass hämtar värdet för attributet med den angivna 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

Parametrar

name
String

Attributets kvalificerade namn.

Returer

String

Värdet för det angivna attributet. Om attributet inte hittas eller om värdet är String.Empty, null returneras.

Undantag

ArgumentNullException

name är null.

InvalidOperationException

En XmlReader metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".

Exempel

I följande exempel hämtas värdet för ISBN-attributet.

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)

Kommentarer

Den här metoden flyttar inte läsaren.

Om läsaren är placerad på en DocumentType nod kan den här metoden användas för att hämta public- och SYSTEM-literalerna, till exempel reader.GetAttribute("PUBLIC")

Gäller för