XmlReader.GetAttribute Método

Definição

Espaço de Nomes:
System.Xml
Assemblagens:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.dll
Assemblagem:
System.Xml.ReaderWriter.dll
Assemblagem:
netstandard.dll

Quando sobrescrito numa classe derivada, obtém o valor de um atributo.

Sobrecargas

Name Description
GetAttribute(String, String)

Quando sobrescrito numa classe derivada, obtém o valor do atributo com o especificado LocalName e NamespaceURI.
GetAttribute(Int32)

Quando sobrescrito numa classe derivada, obtém o valor do atributo com o índice especificado.
GetAttribute(String)

Quando sobrescrito numa classe derivada, obtém o valor do atributo com o especificado Name.

GetAttribute(String, String)

Quando sobrescrito numa classe derivada, obtém o valor do atributo com o especificado LocalName e 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

O nome local do atributo.

namespaceURI
String

O URI do namespace do atributo.

Devoluções

String

O valor do atributo especificado. Se o atributo não for encontrado ou o valor for String.Empty, null é devolvido. Este método não emociona o leitor.

Exceções

ArgumentNullException

name é null.

InvalidOperationException

Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

Observações

O seguinte XML contém um atributo num espaço de nomes específico:

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

Pode procurar o dt:type atributo usando um argumento (prefixo e nome local) ou dois argumentos (nome local e espaço de nomes URI):

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

Para procurar 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/);

Também pode obter esta informação através da Prefix propriedade.

Aplica-se a

GetAttribute(Int32)

Quando sobrescrito numa 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.)

Devoluções

String

O valor do atributo especificado. Este método não emociona o leitor.

Exceções

ArgumentOutOfRangeException

i está fora do alcance. Deve ser não negativo e inferior ao tamanho da coleção de atributos.

InvalidOperationException

Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

Exemplos

O exemplo seguinte 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)

Aplica-se a

GetAttribute(String)

Quando sobrescrito numa classe derivada, obtém o valor do atributo com o especificado 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

O nome qualificado do atributo.

Devoluções

String

O valor do atributo especificado. Se o atributo não for encontrado ou o valor for String.Empty, null é devolvido.

Exceções

ArgumentNullException

name é null.

InvalidOperationException

Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

Exemplos

O exemplo seguinte 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)

Observações

Este método não emociona o leitor.

Se o leitor estiver posicionado num DocumentType nó, este método pode ser usado para obter os literais PUBLIC e SYSTEM, por exemplo, reader.GetAttribute("PUBLIC")

Aplica-se a