XmlReader.GetAttribute Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Quando substituído em uma classe derivada, obtém o valor de um atributo.

Sobrecargas

GetAttribute(String, String)	Quando substituído em uma classe derivada, obtém o valor do atributo com o LocalName e o NamespaceURI especificados.
GetAttribute(Int32)	Quando substituído em uma classe derivada, obtém o valor do atributo com o índice especificado.
GetAttribute(String)	Quando substituído em uma classe derivada, obtém o valor do atributo com o Name especificado.

GetAttribute(String, String)

Quando substituído em uma classe derivada, obtém o valor do atributo com o LocalName e o NamespaceURI especificados.

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

O nome local do atributo.

namespaceURI

String

O URI do namespace do atributo.

Retornos

String

O valor do atributo especificado. Se o atributo não foi encontrado ou o valor é String.Empty, null será retornado. Esse método não move o leitor.

Exceções

ArgumentNullException

name é null.

InvalidOperationException

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Comentários

O XML a seguir contém um atributo em um namespace específico:

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

Você pode pesquisar o dt:type atributo usando um argumento (prefixo e nome local) ou dois argumentos (nome local e URI de namespace):

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

Para pesquisar o xmlns:dt atributo, use um dos seguintes argumentos:

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

Você também pode obter essas informações usando a Prefix propriedade.

GetAttribute(Int32)

Quando substituído em uma classe derivada, obtém o valor do atributo com o í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

O índice do atributo. O índice é baseado em zero. (O primeiro atributo tem índice 0.)

Retornos

String

O valor do atributo especificado. Esse método não move o leitor.

Exceções

ArgumentOutOfRangeException

i está fora do intervalo. Ele deve ser não negativo e menor que o tamanho da coleção de atributos.

InvalidOperationException

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Exemplos

O exemplo a seguir obtém o valor do terceiro atributo.

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

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

GetAttribute(String)

Quando substituído em uma classe derivada, obtém o valor do atributo com o Name especificado.

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

O nome qualificado do atributo.

Retornos

String

O valor do atributo especificado. Se o atributo não foi encontrado ou o valor é String.Empty, null será retornado.

Exceções

ArgumentNullException

name é null.

InvalidOperationException

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Exemplos

O exemplo a seguir obtém o valor do 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)

Comentários

Esse método não move o leitor.

Se o leitor estiver posicionado em um DocumentType nó, esse método poderá ser usado para obter os literais PUBLIC e SYSTEM, por exemplo, reader.GetAttribute("PUBLIC")