XmlReader.GetAttribute Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Quando sottoposto a override in una classe derivata, ottiene il valore di un attributo.

Overload

GetAttribute(String, String)	Quando sottoposto a override in una classe derivata, ottiene il valore dell'attributo con le proprietà LocalName e NamespaceURI specificate.
GetAttribute(Int32)	Quando ne viene eseguito l'override in una classe derivata, ottiene il valore dell'attributo con l'indice specificato.
GetAttribute(String)	Quando sottoposto a override in una classe derivata, ottiene il valore dell'attributo con la proprietà Name specificata.

GetAttribute(String, String)

Origine:

XmlReader.cs

Quando sottoposto a override in una classe derivata, ottiene il valore dell'attributo con le proprietà LocalName e NamespaceURI specificate.

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

Parametri

name

String

Nome locale dell'attributo.

namespaceURI

String

URI dello spazio dei nomi dell'attributo.

Restituisce

String

Valore dell'attributo specificato. Se l'attributo non viene trovato o se il valore è String.Empty, verrà restituito null. Questo metodo non determina lo spostamento del lettore.

Eccezioni

ArgumentNullException

name è null.

InvalidOperationException

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

Commenti

Il codice XML seguente contiene un attributo in uno spazio dei nomi specifico:

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

È possibile cercare l'attributo dt:type usando un argomento (prefisso e nome locale) o due argomenti (nome locale e URI dello spazio dei nomi):

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

Per cercare l'attributo xmlns:dt , usare uno degli argomenti seguenti:

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

È anche possibile ottenere queste informazioni usando la Prefix proprietà .

GetAttribute(Int32)

Origine:

XmlReader.cs

Quando ne viene eseguito l'override in una classe derivata, ottiene il valore dell'attributo con l'indice specificato.

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

Parametri

i

Int32

Indice dell'attributo. L'indice è in base zero. Il primo attributo ha indice 0.

Restituisce

String

Valore dell'attributo specificato. Questo metodo non determina lo spostamento del lettore.

Eccezioni

ArgumentOutOfRangeException

i non è compreso nell'intervallo consentito. Richiesto valore non negativo e minore della dimensione dell'insieme di attributi.

InvalidOperationException

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

Esempio

Nell'esempio seguente viene restituito il valore del terzo attributo.

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

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

GetAttribute(String)

Origine:

XmlReader.cs

Quando sottoposto a override in una classe derivata, ottiene il valore dell'attributo con la proprietà Name specificata.

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

Parametri

name

String

Nome completo dell'attributo.

Restituisce

String

Valore dell'attributo specificato. Se l'attributo non viene trovato o se il valore è String.Empty, verrà restituito null.

Eccezioni

ArgumentNullException

name è null.

InvalidOperationException

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

Esempio

Nell'esempio seguente viene restituito il valore dell'attributo 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)

Commenti

Questo metodo non determina lo spostamento del lettore.

Se il lettore è posizionato in un DocumentType nodo, questo metodo può essere usato per ottenere i valori letterali PUBLIC e SYSTEM, ad esempio reader.GetAttribute("PUBLIC")