Recuperación de nodos desordenados por nombre o índice

La clase XmlNamedNodeMap se describe en la especificación del W3C como NamedNodeMap y es necesaria para controlar un conjunto de nodos desordenado con la capacidad de hacer referencia a los mismos mediante su nombre o índice. El único modo de acceder a una clase XmlNamedNodeMap es devolverla a través de un método o una propiedad. Hay tres métodos o propiedades que devuelven una clase XmlNamedNodeMap:

• XmlElement.Attributes

• XmlDocumentType.Entities

• XmlDocumentType.Notations

Por ejemplo, la propiedad XmlDocumentType.Entities obtiene la colección de nodos XmlEntity declarada en la declaración de tipos de documento. Esta colección se devuelve como una clase XmlNamedNodeMap y se puede recorrer en iteración mediante la propiedad Count. También se puede mostrar información de entidad. Para obtener un ejemplo de cómo recorrer en iteración una clase XmlNamedNodeMap, vea Entities.

La clase XmlAttributeCollection se deriva de XmlNamedNodeMap y solo los atributos son modificables, mientras que las notaciones y entidades son de solo lectura. Si utiliza XmlNamedNodeMap para los atributos, puede obtener nodos para dichos atributos en función de sus nombres XML. De este modo se proporciona un método sencillo de manipular la colección de atributos en un nodo de elemento. Esto se puede contrastar directamente con XmlNodeList, que también implementa la interfaz IEnumerable, pero con un descriptor de acceso de índice en lugar de una cadena. Los métodos RemoveNamedItem y SetNamedItem solo se utilizan con respecto a XmlAttributeCollection. Si se agrega o quita de una colección de atributos, independientemente de que se utilice la implementación de AttributeCollection o XmlNamedNodeMap, se modifica la colección de atributos del elemento. En el ejemplo de código siguiente se muestra cómo se mueve un atributo y se crea un atributo nuevo.

Imports System  
Imports System.Xml  
  
Class test  
  
    Public Shared Sub Main()  
        Dim doc As New XmlDocument()  
        doc.LoadXml("<root> <child1 attr1='val1' attr2='val2'> text1 </child1> <child2 attr3='val3'> text2 </child2> </root> ")  
  
        ' Get the attributes of node "child2 "  
        Dim ac As XmlAttributeCollection = doc.DocumentElement.ChildNodes(1).Attributes  
  
        ' Print out the number of attributes and their names.  
        Console.WriteLine(("Number of Attributes: " + ac.Count))  
        Dim i As Integer  
        For i = 0 To ac.Count - 1  
            Console.WriteLine((i + 1 + ".  Attribute Name: '" + ac(i).Name + "'  Attribute Value:  '" + ac(i).Value + "'"))  
        Next i  
        ' Get the 'attr1' from child1.  
        Dim attr As XmlAttribute = doc.DocumentElement.ChildNodes(0).Attributes(0)  
  
        ' Add this attribute to the attributecollection "ac".  
        ac.SetNamedItem(attr)  
  
        ''attr1' will be removed from 'child1' and added to 'child2'.  
        ' Print out the number of attributes and their names.  
        Console.WriteLine(("Number of Attributes: " + ac.Count))  
  
        For i = 0 To ac.Count - 1  
            Console.WriteLine((i + 1 + ".  Attribute Name: '" + ac(i).Name + "'  Attribute Value:  '" + ac(i).Value + "'"))  
        Next i  
        ' Create a new attribute and add to the collection.  
        Dim attr2 As XmlAttribute = doc.CreateAttribute("attr4")  
        attr2.Value = "val4"  
        ac.SetNamedItem(attr2)  
  
        ' Print out the number of attributes and their names.  
        Console.WriteLine(("Number of Attributes: " + ac.Count))  
  
        For i = 0 To ac.Count - 1  
            Console.WriteLine((i + 1 + ".  Attribute Name: '" + ac(i).Name + "'  Attribute Value:  '" + ac(i).Value + "'"))  
        Next i  
    End Sub 'Main  
End Class 'test  

using System;  
using System.Xml;  
class test {  
    public static void Main() {  
        XmlDocument doc = new XmlDocument();  
        doc.LoadXml( "<root> <child1 attr1='val1' attr2='val2'> text1 </child1> <child2 attr3='val3'> text2 </child2> </root> " );  
  
        // Get the attributes of node "child2"  
        XmlAttributeCollection ac = doc.DocumentElement.ChildNodes[1].Attributes;  
  
        // Print out the number of attributes and their names.  
        Console.WriteLine( "Number of Attributes: "+ac.Count );  
        for( int i = 0; i < ac.Count; i++ )  
            Console.WriteLine( (i+1) + ".  Attribute Name: '" +ac[i].Name+ "'  Attribute Value:  '"+ ac[i].Value +"'" );
  
        // Get the 'attr1' from child1.  
        XmlAttribute attr = doc.DocumentElement.ChildNodes[0].Attributes[0];  
  
        // Add this attribute to the attributecollection "ac".  
        ac.SetNamedItem( attr );  
  
        // 'attr1' will be removed from 'child1' and added to 'child2'.  
        // Print out the number of attributes and their names.  
        Console.WriteLine( "Number of Attributes: "+ac.Count );
        for( int i = 0; i < ac.Count; i++ )  
            Console.WriteLine( (i+1) + ".  Attribute Name: '" +ac[i].Name+ "'  Attribute Value:  '"+ ac[i].Value +"'" );
  
        // Create a new attribute and add to the collection.  
        XmlAttribute attr2 = doc.CreateAttribute( "attr4" );  
        attr2.Value = "val4";  
        ac.SetNamedItem( attr2 );  
  
        // Print out the number of attributes and their names.  
        Console.WriteLine( "Number of Attributes: "+ac.Count );
        for( int i = 0; i < ac.Count; i++ )  
            Console.WriteLine( (i+1) + ".  Attribute Name: '" +ac[i].Name+ "'  Attribute Value:  '"+ ac[i].Value +"'" );
  
    }  
}  

Para ver un ejemplo de código adicional donde se muestre un atributo que se ha quitado de una clase AttributeCollection, vea XmlNamedNodeMap.RemoveNamedItem (método). Para más información sobre los métodos y las propiedades, vea XmlNamedNodeMap (miembros).

Vea también

• Document Object Model (DOM) para XML