XElement.Attributes Método

Definição

Namespace:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Assembly:

System.Xml.Linq.dll

Assembly:

netstandard.dll

Retorna uma coleção de atributos desse elemento.

Sobrecargas

Attributes()	Retorna uma coleção de atributos desse elemento.
Attributes(XName)	Retorna uma coleção filtrada de atributos desse elemento. Somente atributos que têm um XName correspondente são incluídos na coleção.

Comentários

Este método utiliza execução adiada.

Attributes()

Retorna uma coleção de atributos desse elemento.

public:
 System::Collections::Generic::IEnumerable<System::Xml::Linq::XAttribute ^> ^ Attributes();

public System.Collections.Generic.IEnumerable<System.Xml.Linq.XAttribute> Attributes ();

member this.Attributes : unit -> seq<System.Xml.Linq.XAttribute>

Public Function Attributes () As IEnumerable(Of XAttribute)

Retornos

IEnumerable<XAttribute>

Um IEnumerable<T> do XAttribute de atributos desse elemento.

Exemplos

O exemplo a seguir cria um elemento com dois atributos. Em seguida, ele usa isso para recuperar todos os atributos do elemento.

XElement xmlTree = new XElement("Root",  
    new XAttribute("Att1", "content1"),  
    new XAttribute("Att2", "content2")  
);  
IEnumerable<XAttribute> attList =  
    from at in xmlTree.Attributes()  
    select at;  
foreach (XAttribute att in attList)  
    Console.WriteLine(att);  

Dim xmlTree As XElement = <Root Att1="content1" Att2="content2"/>  

Dim attList As IEnumerable(Of XAttribute) = _  
From at In xmlTree.Attributes() _  
Select at  

For Each att In attList  
    Console.WriteLine(att)  
Next  

Esse exemplo gera a saída a seguir:

Att1="content1"  
Att2="content2"  

O exemplo a seguir é o mesmo, mas nesse caso o XML está em um namespace. Para obter mais informações, consulte Trabalhar com namespaces XML.

XNamespace aw = "http://www.adventure-works.com";  
XElement xmlTree = new XElement(aw + "Root",  
    new XAttribute(aw + "Att1", "content1"),  
    new XAttribute(aw + "Att2", "content2"),  
    new XAttribute(XNamespace.Xmlns + "aw", "http://www.adventure-works.com")  
);  
IEnumerable<XAttribute> attList =  
    from at in xmlTree.Attributes()  
    select at;  
foreach (XAttribute att in attList)  
    Console.WriteLine(att);  

Imports <xmlns:aw="http://www.adventure-works.com">  

Module Module1  
    Sub Main()  
        Dim xmlTree As XElement = <aw:Root aw:Att1="content1" aw:Att2="content2"/>  

        Dim attList As IEnumerable(Of XAttribute) = _  
            From at In xmlTree.Attributes() _  
            Select at  

        For Each att In attList  
            Console.WriteLine(att)  
        Next  
    End Sub  
End Module  

Esse exemplo gera a saída a seguir:

aw:Att1="content1"  
aw:Att2="content2"  
xmlns:aw="http://www.adventure-works.com"  

Comentários

Os atributos na coleção retornada estão na ordem em que foram adicionados ao elemento. Se a árvore XML tiver sido analisada a partir de XML, os atributos serão retornados na ordem do documento.

Este método utiliza execução adiada.

Confira também

• Elements()
• Visão geral do LINQ to XML

Attributes(XName)

Retorna uma coleção filtrada de atributos desse elemento. Somente atributos que têm um XName correspondente são incluídos na coleção.

public:
 System::Collections::Generic::IEnumerable<System::Xml::Linq::XAttribute ^> ^ Attributes(System::Xml::Linq::XName ^ name);

public System.Collections.Generic.IEnumerable<System.Xml.Linq.XAttribute> Attributes (System.Xml.Linq.XName name);

public System.Collections.Generic.IEnumerable<System.Xml.Linq.XAttribute> Attributes (System.Xml.Linq.XName? name);

member this.Attributes : System.Xml.Linq.XName -> seq<System.Xml.Linq.XAttribute>

Public Function Attributes (name As XName) As IEnumerable(Of XAttribute)

Parâmetros

name

XName

O XName correspondente.

Retornos

IEnumerable<XAttribute>

Um IEnumerable<T> do XAttribute que contém os atributos deste elemento. Somente atributos que têm um XName correspondente são incluídos na coleção.

Exemplos

O exemplo a seguir usa este .

XElement xmlTree = new XElement("Root",  
    new XAttribute("Att1", "content1"),  
    new XAttribute("Att2", "content2")  
);  
IEnumerable<XAttribute> attList = xmlTree.Attributes("Att1");  
foreach (XAttribute att in attList)  
    Console.WriteLine(att);  

Dim xmlTree As XElement = <Root Att1="content1" Att2="content2"/>  

Dim attList As IEnumerable(Of XAttribute) = xmlTree.Attributes("Att1")  

For Each att In attList  
    Console.WriteLine(att)  
Next  

Esse exemplo gera a saída a seguir:

Att1="content1"  

O exemplo a seguir é o mesmo, mas nesse caso o XML está em um namespace. Para obter mais informações, consulte Trabalhar com namespaces XML.

XNamespace aw = "http://www.adventure-works.com";  
XElement xmlTree = new XElement(aw + "Root",  
    new XAttribute(XNamespace.Xmlns + "aw", "http://www.adventure-works.com"),  
    new XAttribute(aw + "Att1", "content1"),  
    new XAttribute(aw + "Att2", "content2")  
);  
IEnumerable<XAttribute> attList = xmlTree.Attributes(aw + "Att1");  
foreach (XAttribute att in attList)  
    Console.WriteLine(att);  

Imports <xmlns:aw="http://www.adventure-works.com">  

Module Module1  
    Sub Main()  
        Dim xmlTree As XElement = <aw:Root aw:Att1="content1" aw:Att2="content2"/>  

        Dim attList As IEnumerable(Of XAttribute) = xmlTree.Attributes(GetXmlNamespace(aw) + "Att1")  

        For Each att In attList  
            Console.WriteLine(att)  
        Next  
    End Sub  
End Module  

Esse exemplo gera a saída a seguir:

aw:Att1="content1"  

Comentários

Os nomes de atributo devem ser exclusivos dentro de um elemento. Portanto, isso pode retornar uma coleção que contém apenas um atributo ou pode retornar uma coleção vazia.

Este método utiliza execução adiada.

Confira também

• Visão geral do LINQ to XML