XmlReader.GetAttribute XmlReader.GetAttribute XmlReader.GetAttribute XmlReader.GetAttribute Method

Definición

Cuando se invalida en una clase derivada, obtiene el valor de un atributo.When overridden in a derived class, gets the value of an attribute.

Sobrecargas

GetAttribute(String, String) GetAttribute(String, String) GetAttribute(String, String) GetAttribute(String, String)

Cuando se invalida en una clase derivada, obtiene el valor del atributo con las propiedades LocalName y NamespaceURI especificadas.When overridden in a derived class, gets the value of the attribute with the specified LocalName and NamespaceURI.

GetAttribute(Int32) GetAttribute(Int32) GetAttribute(Int32) GetAttribute(Int32)

Cuando se invalida en una clase derivada, obtiene el valor del atributo con el índice especificado.When overridden in a derived class, gets the value of the attribute with the specified index.

GetAttribute(String) GetAttribute(String) GetAttribute(String) GetAttribute(String)

Cuando se invalida en una clase derivada, obtiene el valor del atributo con la propiedad Name especificada.When overridden in a derived class, gets the value of the attribute with the specified Name.

GetAttribute(String, String) GetAttribute(String, String) GetAttribute(String, String) GetAttribute(String, String)

Cuando se invalida en una clase derivada, obtiene el valor del atributo con las propiedades LocalName y NamespaceURI especificadas.When overridden in a derived class, gets the value of the attribute with the specified LocalName and 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

Parámetros

name
String String String String

Nombre local del atributo.The local name of the attribute.

namespaceURI
String String String String

URI de espacio de nombres del atributo.The namespace URI of the attribute.

Devoluciones

Valor del atributo especificado.The value of the specified attribute. Si no se encuentra el atributo o el valor es String.Empty, se devuelve null.If the attribute is not found or the value is String.Empty, null is returned. Este método no desplaza el lector.This method does not move the reader.

Excepciones

Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior.An XmlReader method was called before a previous asynchronous operation finished. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Comentarios

El siguiente código XML contiene un atributo en un espacio de nombres específico:The following XML contains an attribute in a specific namespace:

<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 de espacio de nombres):You can lookup the dt:type attribute using one argument (prefix and local name) or two arguments (local name and namespace URI):

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:To lookup the xmlns:dt attribute, use one of the following arguments:

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.You can also get this information using the Prefix property.

GetAttribute(Int32) GetAttribute(Int32) GetAttribute(Int32) GetAttribute(Int32)

Cuando se invalida en una clase derivada, obtiene el valor del atributo con el índice especificado.When overridden in a derived class, gets the value of the attribute with the specified index.

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 Int32 Int32 Int32

Índice del atributo.The index of the attribute. El índice está basado en cero.The index is zero-based. El primer atributo tiene índice 0.(The first attribute has index 0.)

Devoluciones

Valor del atributo especificado.The value of the specified attribute. Este método no desplaza el lector.This method does not move the reader.

Excepciones

i está fuera del intervalo.i is out of range. Debe ser no negativo y menor que el tamaño de la colección de atributos.It must be non-negative and less than the size of the attribute collection.

Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior.An XmlReader method was called before a previous asynchronous operation finished. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Ejemplos

En el ejemplo siguiente se obtiene el valor del tercer atributo.The following example gets the value of the third attribute.

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

GetAttribute(String) GetAttribute(String) GetAttribute(String) GetAttribute(String)

Cuando se invalida en una clase derivada, obtiene el valor del atributo con la propiedad Name especificada.When overridden in a derived class, gets the value of the attribute with the specified 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

Parámetros

name
String String String String

Nombre completo del atributo.The qualified name of the attribute.

Devoluciones

Valor del atributo especificado.The value of the specified attribute. Si no se encuentra el atributo o el valor es String.Empty, se devuelve null.If the attribute is not found or the value is String.Empty, null is returned.

Excepciones

Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior.An XmlReader method was called before a previous asynchronous operation finished. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Ejemplos

En el ejemplo siguiente se obtiene el valor del atributo ISBN.The following example gets the value of the ISBN attribute.

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.This method does not move the reader.

Si el lector está situado en un DocumentType nodo, este método se puede usar para obtener los literales públicos y del sistema, por ejemplo,reader.GetAttribute("PUBLIC")If the reader is positioned on a DocumentType node, this method can be used to get the PUBLIC and SYSTEM literals, for example, reader.GetAttribute("PUBLIC")

Se aplica a