Доступ к атрибутам в модели DOMAccessing Attributes in the DOM

Атрибуты - свойства элемента, а не его дочерние элементы.Attributes are properties of the element, not children of the element. Это различие очень важно из-за методов, используемых для перемещения по дочерним, родительским и одноуровневым узлам модели XML DOM.This distinction is important because of the methods used to navigate sibling, parent, and child nodes of the XML Document Object Model (DOM). Например, методы PreviousSibling и NextSibling не позволяют перемещаться с элемента на атрибут или с одного атрибута на другой.For example, the PreviousSibling and NextSibling methods are not used to navigate from an element to an attribute or between attributes. Вместо этого атрибут является свойством элемента и принадлежит ему. У атрибута есть специальные методы навигации и свойство OwnerElement, но нет свойства parentNode.Instead, an attribute is a property of an element and is owned by an element, has an OwnerElement property and not a parentNode property, and has distinct methods of navigation.

Если текущий узел является элементом, метод HasAttribute позволяет узнать, есть ли у него атрибуты.When the current node is an element, use the HasAttribute method to see if there are any attributes associated with the element. Если у элемента есть атрибуты, к ним можно получить доступ различными методами.Once it is known that an element has attributes, there are multiple methods for accessing attributes. Чтобы получить отдельный атрибут элементв, используйте методы GetAttribute и GetAttributeNode класса XmlElement. Также есть возможность получить все атрибуты сразу в виде коллекции.To retrieve a single attribute from the element, you can use the GetAttribute and GetAttributeNode methods of the XmlElement or you can obtain all the attributes into a collection. Получение коллекции удобно, если предполагается ее обзор.Obtaining the collection is useful if you need to iterate over the collection. Если нужно получить все атрибуты конкретного элемента, воспользуйтесь его свойством Attributes для получения всех атрибутов в виде коллекции.If you want all attributes from the element, use the Attributes property of the element to retrieve all the attributes into a collection.

Получение всех атрибутов в виде коллекцииRetrieving All Attributes into a Collection

Если нужно поместить все атрибуты узла элемента в коллекцию, вызовите свойство XmlElement.Attributes.If you want all the attributes of an element node put into a collection, call the XmlElement.Attributes property. Оно возвращает коллекцию XmlAttributeCollection со всеми атрибутами элемента.This gets the XmlAttributeCollection that contains all the attributes of an element. Класс XmlAttributeCollection наследует от карты XmlNamedNode.The XmlAttributeCollection class inherits from the XmlNamedNode map. Таким образом, для этой коллекции доступны все свойства и методы, что и для карты именованного узла, а также все методы и свойства класса XmlAttributeCollection, например свойство ItemOf и метод Append.Therefore, the methods and properties available on the collection include those available on a named node map in addition to methods and properties specific to the XmlAttributeCollection class, such as the ItemOf property or the Append method. Каждый элемент коллекции атрибутов представляет узел XmlAttribute.Each item in the attribute collection represents an XmlAttribute node. Чтобы выяснить число атрибутов некоторого элемента, получите коллекцию XmlAttributeCollection и вызовите ее свойство Count, которое содержит число узлов XmlAttribute в коллекции.To find the number of attributes on an element, get the XmlAttributeCollection, and use the Count property to see how many XmlAttribute nodes are in the collection.

В следующем примере кода показано, как получить коллекцию атрибутов и последовательно перебрать ее элементы, используя метод Count в роли индекса цикла.The following code example shows how to retrieve an attribute collection and, using the Count method for the looping index, iterate over it. Затем в примере демонстрируется получение одного атрибута из коллекции и вывод его значения.The code then shows how to retrieve a single attribute from the collection and display its value.

Imports System.IO
Imports System.Xml

Public Class Sample

    Public Shared Sub Main()

        Dim doc As XmlDocument = New XmlDocument()
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5' misc='sale item'>" & _
               "<title>The Handmaid's Tale</title>" & _
               "<price>14.95</price>" & _
               "</book>")

        ' Move to an element.
        Dim myElement As XmlElement = doc.DocumentElement

        ' Create an attribute collection from the element.
        Dim attrColl As XmlAttributeCollection = myElement.Attributes

        ' Show the collection by iterating over it.
        Console.WriteLine("Display all the attributes in the collection...")
        Dim i As Integer
        For i = 0 To attrColl.Count - 1
            Console.Write("{0} = ", attrColl.ItemOf(i).Name)
            Console.Write("{0}", attrColl.ItemOf(i).Value)
            Console.WriteLine()
        Next

        ' Retrieve a single attribute from the collection; specifically, the
        ' attribute with the name "misc".
        Dim attr As XmlAttribute = attrColl("misc")

        ' Retrieve the value from that attribute.
        Dim miscValue As String = attr.InnerXml

        Console.WriteLine("Display the attribute information.")
        Console.WriteLine(miscValue)

    End Sub
End Class
using System;
using System.IO;
using System.Xml;

public class Sample
{

    public static void Main()
    {
        XmlDocument doc = new XmlDocument();
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5' misc='sale item'>" +
                      "<title>The Handmaid's Tale</title>" +
                      "<price>14.95</price>" +
                      "</book>");

        // Move to an element.
        XmlElement myElement = doc.DocumentElement;

        // Create an attribute collection from the element.
        XmlAttributeCollection attrColl = myElement.Attributes;

        // Show the collection by iterating over it.
        Console.WriteLine("Display all the attributes in the collection...");
        for (int i = 0; i < attrColl.Count; i++)
        {
            Console.Write("{0} = ", attrColl[i].Name);
            Console.Write("{0}", attrColl[i].Value);
            Console.WriteLine();
        }

        // Retrieve a single attribute from the collection; specifically, the
        // attribute with the name "misc".
        XmlAttribute attr = attrColl["misc"];

        // Retrieve the value from that attribute.
        String miscValue = attr.InnerXml;

        Console.WriteLine("Display the attribute information.");
        Console.WriteLine(miscValue);

    }
}

Этот пример выводит следующие данные:This example displays the following output:

ВыводOutput

Отображает все атрибуты из коллекции.Display all the attributes in the collection.

genre = novel
ISBN = 1-861001-57-5
misc = sale item
Display the attribute information.
sale item

Информация из коллекции атрибутов может быть получена по имени или по значению индекса.The information in an attribute collection can be retrieved by name or index number. В примере показано получение данных по имени.The example above shows how to retrieve data by name. В следующем примере показано получение данных по значению индекса.The next example shows how to retrieve data by index number.

XmlAttributeCollection является коллекцией, которую можно обходить по имени или индексу. В этом примере мы выбираем из коллекции первый атрибут по индексу (нумерация начинается с нуля) и применяем файл baseuri.xml в качестве источника входных данных.Because the XmlAttributeCollection is a collection and can be iterated over by name or index, this example shows selecting the first attribute out of the collection using a zero-based index and using the following file, baseuri.xml, as input.

InputInput

<!-- XML fragment -->
<book genre="novel">
  <title>Pride And Prejudice</title>
</book>
Option Explicit On
Option Strict On

Imports System.IO
Imports System.Xml

Public Class Sample

    Public Shared Sub Main()
        ' Create the XmlDocument.
        Dim doc As New XmlDocument()
        doc.Load("http://localhost/baseuri.xml")

        ' Display information on the attribute node. The value
        ' returned for BaseURI is 'http://localhost/baseuri.xml'.
        Dim attr As XmlAttribute = doc.DocumentElement.Attributes(0)
        Console.WriteLine("Name of the attribute:  {0}", attr.Name)
        Console.WriteLine("Base URI of the attribute:  {0}", attr.BaseURI)
        Console.WriteLine("The value of the attribute:  {0}", attr.InnerText)
    End Sub 'Main
End Class 'Sample
using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    // Create the XmlDocument.
    XmlDocument doc = new XmlDocument();

    doc.Load("http://localhost/baseuri.xml");

    // Display information on the attribute node. The value
    // returned for BaseURI is 'http://localhost/baseuri.xml'.
    XmlAttribute attr = doc.DocumentElement.Attributes[0];
    Console.WriteLine("Name of the attribute:  {0}", attr.Name);
    Console.WriteLine("Base URI of the attribute:  {0}", attr.BaseURI);
    Console.WriteLine("The value of the attribute:  {0}", attr.InnerText);
  }
}

Получение единичного узла атрибутаRetrieving an Individual Attribute Node

Для получения из элемента одного узла атрибута используется метод XmlElement.GetAttributeNode.To retrieve a single attribute node from an element, the XmlElement.GetAttributeNode method is used. Он возвращает объект типа XmlAttribute.It returns an object of type XmlAttribute. Для полученного объекта XmlAttribute доступны все методы и свойства класса System.Xml.XmlAttribute, например, значение OwnerElement.Once you have an XmlAttribute, all the methods and properties available in the System.Xml.XmlAttribute class are available on that object, such as finding the OwnerElement.

Imports System.IO
Imports System.Xml

Public Class Sample

    Public Shared Sub Main()

        Dim doc As XmlDocument = New XmlDocument()
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5' misc='sale item'>" & _
               "<title>The Handmaid's Tale</title>" & _
               "<price>14.95</price>" & _
               "</book>")

        ' Move to an element.
        Dim root As XmlElement
        root = doc.DocumentElement

        ' Get an attribute.
        Dim attr As XmlAttribute
        attr = root.GetAttributeNode("ISBN")

        ' Display the value of the attribute.
        Dim attrValue As String
        attrValue = attr.InnerXml
        Console.WriteLine(attrValue)

    End Sub
End Class
using System;
using System.IO;
using System.Xml;

 public class Sample
 {
      public static void Main()
      {
    XmlDocument doc = new XmlDocument();
     doc.LoadXml("<book genre='novel' ISBN='1-861003-78' misc='sale item'>" +
                   "<title>The Handmaid's Tale</title>" +
                   "<price>14.95</price>" +
                   "</book>");

    // Move to an element.
     XmlElement root = doc.DocumentElement;

    // Get an attribute.
     XmlAttribute attr = root.GetAttributeNode("ISBN");

    // Display the value of the attribute.
     String attrValue = attr.InnerXml;
     Console.WriteLine(attrValue);

    }
}

Можно также поступить как в предыдущем примере, где единичный узел атрибута был получен из коллекции атрибутов.You can also do as shown in the previous example, where a single attribute node is retrieved from the attribute collection. Следующий пример демонстрирует, как с помощью одной строки кода получить по значению индекса один атрибут из корневого элемента дерева XML-документа, существующего в виде свойства DocumentElement.The following code example shows how one line of code can be written to retrieve a single attribute by index number from the root of the XML document tree, also known as the DocumentElement property.

XmlAttribute attr = doc.DocumentElement.Attributes[0];

См. также:See also