XPathNavigator.CreateAttributes 方法

public:
 virtual System::Xml::XmlWriter ^ CreateAttributes();

public virtual System.Xml.XmlWriter CreateAttributes();

abstract member CreateAttributes : unit -> System.Xml.XmlWriter
override this.CreateAttributes : unit -> System.Xml.XmlWriter

Public Overridable Function CreateAttributes () As XmlWriter

返回

XmlWriter用于在当前元素上创建新属性的对象。

例外

示例

在以下示例中，使用discount方法返回的currency对象，在price文件中第一个book元素的contosoBooks.xml子元素上创建新的XmlWriter属性和CreateAttributes属性。

XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToChild("bookstore", "http://www.contoso.com/books");
navigator.MoveToChild("book", "http://www.contoso.com/books");
navigator.MoveToChild("price", "http://www.contoso.com/books");

XmlWriter attributes = navigator.CreateAttributes();

attributes.WriteAttributeString("discount", "1.00");
attributes.WriteAttributeString("currency", "USD");
attributes.Close();

navigator.MoveToParent();
Console.WriteLine(navigator.OuterXml);

Dim document As XmlDocument = New XmlDocument()
document.Load("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToChild("bookstore", "http://www.contoso.com/books")
navigator.MoveToChild("book", "http://www.contoso.com/books")
navigator.MoveToChild("price", "http://www.contoso.com/books")

Dim attributes As XmlWriter = navigator.CreateAttributes()

attributes.WriteAttributeString("discount", "1.00")
attributes.WriteAttributeString("currency", "USD")
attributes.Close()

navigator.MoveToParent()
Console.WriteLine(navigator.OuterXml)

该示例将 contosoBooks.xml 文件作为输入。

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="http://www.contoso.com/books">
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">
        <title>The Autobiography of Benjamin Franklin</title>
        <author>
            <first-name>Benjamin</first-name>
            <last-name>Franklin</last-name>
        </author>
        <price>8.99</price>
    </book>
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">
        <title>The Confidence Man</title>
        <author>
            <first-name>Herman</first-name>
            <last-name>Melville</last-name>
        </author>
        <price>11.99</price>
    </book>
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">
        <title>The Gorgias</title>
        <author>
            <name>Plato</name>
        </author>
        <price>9.99</price>
    </book>
</bookstore>

注解

以下是使用 CreateAttributes 该方法时要考虑的重要说明。

• 当定位 XPathNavigator 在元素上时，该方法创建 XPathNavigator 的新属性将放置在当前元素的属性列表的末尾。

• 在调用对象的方法Close之前XmlWriter，不会插入新属性。

• 如果指定的命名空间前缀为 String.Empty 或 null，则从当前范围内的命名空间获取新属性的命名空间 URI 的前缀。 如果当前范围内没有分配给指定命名空间 URI 的命名空间前缀，则自动生成命名空间前缀。 例如，若要在文件的默认命名空间contosoBooks.xml中的元素上创建新属性（xmlns="http://www.contoso.com/books"），请指定或null同时指定String.Empty命名空间前缀和命名空间 URI 参数。 指定 http://www.contoso.com/books 为命名空间 URI 参数将导致 CreateAttribute 该方法自动生成新属性的命名空间前缀。

• 如果创建的新属性是与元素上的命名空间声明冲突的命名空间节点，要么是因为选择的命名空间前缀由同一作用域的另一个命名空间声明使用，或者因为所选前缀与元素的前缀相同，但绑定到其他命名空间 URI，则会引发异常。

• XmlWriter返回的对象只能用于创建属性。 调用不创建属性的其他 XmlWriter 对象方法将引发异常。

• 该方法 CreateAttributes 不会影响该 XPathNavigator方法的位置。