XmlReader.GetAttribute Método

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Ensamblado:

System.Xml.dll

Ensamblado:

netstandard.dll

Cuando se invalida en una clase derivada, obtiene el valor de un atributo.

Sobrecargas

GetAttribute(String, String)	Cuando se invalida en una clase derivada, obtiene el valor del atributo con las propiedades LocalName y NamespaceURI especificadas.
GetAttribute(Int32)	Cuando se invalida en una clase derivada, obtiene el valor del atributo con el índice especificado.
GetAttribute(String)	Cuando se invalida en una clase derivada, obtiene el valor del atributo con la propiedad Name especificada.

GetAttribute(String, String)

Cuando se invalida en una clase derivada, obtiene el valor del atributo con las propiedades LocalName y NamespaceURI especificadas.

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

Parámetros

name

String

Nombre local del atributo.

namespaceURI

String

URI de espacio de nombres del atributo.

Devoluciones

String

Valor del atributo especificado. Si no se encuentra el atributo o el valor es String.Empty, se devuelve null. Este método no desplaza el lector.

Excepciones

ArgumentNullException

name es null.

InvalidOperationException

Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.

Comentarios

El siguiente XML contiene un atributo en un espacio de nombres específico:

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

Puede buscar el dt:type atributo mediante un argumento (prefijo y nombre local) o dos argumentos (nombre local y URI del espacio de nombres):

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

Para buscar el xmlns:dt atributo, use uno de los argumentos siguientes:

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

También puede obtener esta información mediante la Prefix propiedad .

GetAttribute(Int32)

Cuando se invalida en una clase derivada, obtiene el valor del atributo con el índice especificado.

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

Parámetros

i

Int32

Índice del atributo. El índice está basado en cero. El primer atributo tiene índice 0.

Devoluciones

String

Valor del atributo especificado. Este método no desplaza el lector.

Excepciones

ArgumentOutOfRangeException

i está fuera del intervalo. Debe ser no negativo y menor que el tamaño de la colección de atributos.

InvalidOperationException

Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.

Ejemplos

En el ejemplo siguiente se obtiene el valor del tercer atributo.

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

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

GetAttribute(String)

Cuando se invalida en una clase derivada, obtiene el valor del atributo con la propiedad Name especificada.

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

Parámetros

name

String

Nombre completo del atributo.

Devoluciones

String

Valor del atributo especificado. Si no se encuentra el atributo o el valor es String.Empty, se devuelve null.

Excepciones

ArgumentNullException

name es null.

InvalidOperationException

Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.

Ejemplos

En el ejemplo siguiente se obtiene el valor del atributo 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)

Comentarios

Este método no desplaza el lector.

Si el lector está colocado en un DocumentType nodo, este método se puede usar para obtener los literales PUBLIC y SYSTEM, por ejemplo, reader.GetAttribute("PUBLIC")