XmlTextReader.GetAttribute Método

Definição

Obtém o valor de um atributo.Gets the value of an attribute.

Sobrecargas

GetAttribute(Int32)

Obtém o valor do atributo com o índice especificado.Gets the value of the attribute with the specified index.

GetAttribute(String)

Obtém o valor do atributo com o nome especificado.Gets the value of the attribute with the specified name.

GetAttribute(String, String)

Obtém o valor do atributo com o nome do local e o URI de namespace especificados.Gets the value of the attribute with the specified local name and namespace URI.

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie XmlReader instâncias usando o XmlReader.Create método para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

GetAttribute(Int32)

Obtém o valor do atributo com o índice especificado.Gets the value of the attribute with the specified index.

public:
 override System::String ^ GetAttribute(int i);
public override string GetAttribute (int i);
override this.GetAttribute : int -> string
Public Overrides Function GetAttribute (i As Integer) As String

Parâmetros

i
Int32

O índice do atributo.The index of the attribute. O índice é baseado em zero.The index is zero-based. (O primeiro atributo tem índice 0.)(The first attribute has index 0.)

Retornos

String

O valor do atributo especificado.The value of the specified attribute.

Exceções

O parâmetro i é menor que 0 ou maior que ou igual a AttributeCount.The i parameter is less than 0 or greater than or equal to AttributeCount.

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie XmlReader instâncias usando o XmlReader.Create método para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

Esse método não move o leitor.This method does not move the reader.

Confira também

Aplica-se a

GetAttribute(String)

Obtém o valor do atributo com o nome especificado.Gets the value of the attribute with the specified name.

public:
 override System::String ^ GetAttribute(System::String ^ name);
public override string? GetAttribute (string name);
public override string GetAttribute (string name);
override this.GetAttribute : string -> string
Public Overrides Function GetAttribute (name As String) As String

Parâmetros

name
String

O nome qualificado do atributo.The qualified name of the attribute.

Retornos

String

O valor do atributo especificado.The value of the specified attribute. Se o atributo não for encontrado, null será retornado.If the attribute is not found, null is returned.

Exemplos

O exemplo a seguir obtém o valor do atributo ISBN.The following example gets the value of the ISBN attribute.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlTextReader^ reader = nullptr;
   try
   {
      
      //Load the reader with the XML file.
      reader = gcnew XmlTextReader( "attrs.xml" );
      
      //Read the ISBN attribute.
      reader->MoveToContent();
      String^ isbn = reader->GetAttribute( "ISBN" );
      Console::WriteLine( "The ISBN value: {0}", isbn );
   }
   finally
   {
      if ( reader != nullptr )
            reader->Close();
   }

}

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    XmlTextReader reader = null;

    try
    {
       //Load the reader with the XML file.
       reader = new XmlTextReader("attrs.xml");

       //Read the ISBN attribute.
       reader.MoveToContent();
       string isbn = reader.GetAttribute("ISBN");
       Console.WriteLine("The ISBN value: " + isbn);
     }
     finally
     {
        if (reader != null)
          reader.Close();
      }
  }
} // End class
Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        Dim reader As XmlTextReader = Nothing
        
        Try
            'Load the reader with the XML file.
            reader = New XmlTextReader("attrs.xml")
            
            'Read the ISBN attribute.
            reader.MoveToContent()
            Dim isbn As String = reader.GetAttribute("ISBN")
            Console.WriteLine("The ISBN value: " & isbn)
        
        Finally
            If Not (reader Is Nothing) Then
                reader.Close()
            End If
        End Try
    End Sub
End Class

O exemplo usa o arquivo, attrs.xml , como entrada.The example uses the file, attrs.xml, as input.


<book genre='novel' ISBN='1-861003-78' pubdate='1987'>
</book>

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie XmlReader instâncias usando o XmlReader.Create método para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

Esse método não move o leitor.This method does not move the reader.

Se o leitor estiver posicionado em um DocumentType nó, esse método poderá ser usado para obter os literais públicos e do sistema, por exemplo, 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")

Confira também

Aplica-se a

GetAttribute(String, String)

Obtém o valor do atributo com o nome do local e o URI de namespace especificados.Gets the value of the attribute with the specified local name and namespace URI.

public:
 override System::String ^ GetAttribute(System::String ^ localName, System::String ^ namespaceURI);
public override string? GetAttribute (string localName, string? namespaceURI);
public override string GetAttribute (string localName, string namespaceURI);
override this.GetAttribute : string * string -> string
Public Overrides Function GetAttribute (localName As String, namespaceURI As String) As String

Parâmetros

localName
String

O nome local do atributo.The local name of the attribute.

namespaceURI
String

O URI do namespace do atributo.The namespace URI of the attribute.

Retornos

String

O valor do atributo especificado.The value of the specified attribute. Se o atributo não for encontrado, null será retornado.If the attribute is not found, null is returned. Esse método não move o leitor.This method does not move the reader.

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie XmlReader instâncias usando o XmlReader.Create método para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

O XML a seguir contém um atributo em um namespace específico:The following XML contains an attribute in a specific namespace:

<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 do namespace):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 pesquisar o xmlns:dt atributo, use um dos seguintes argumentos: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/);  

Você também pode obter essas informações usando a Prefix propriedade.You can also get this information using the Prefix property.

Confira também

Aplica-se a