XPathNavigator.CreateAttributes XPathNavigator.CreateAttributes XPathNavigator.CreateAttributes XPathNavigator.CreateAttributes Method

定義

現在の要素に新しい属性を作成するために使用する XmlWriter オブジェクトを返します。Returns an XmlWriter object used to create new attributes on the current element.

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 オブジェクト。An XmlWriter object used to create new attributes on the current element.

例外

XPathNavigator が要素ノードに配置されていません。The XPathNavigator is not positioned on an element node.

XPathNavigator は編集をサポートしていません。The XPathNavigator does not support editing.

次の例では、discount メソッドから返された currency オブジェクトを使用して、新しい price および book 属性が contosoBooks.xml ファイル内の最初の XmlWriter 要素の CreateAttributes 子要素に作成されます。In the following example, new discount and currency attributes are created on the price child element of the first book element in the contosoBooks.xml file using the XmlWriter object returned from the CreateAttributes method.

XmlDocument^ document = gcnew 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);
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 ファイルを入力として使用します。The example takes the contosoBooks.xml file as an input.

  
<?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メソッドを使用する際に考慮する必要がある重要な注意事項について説明します。The following are important notes to consider when using the CreateAttributes method.

  • が要素に配置されXPathNavigatorている場合、メソッドによって作成された新しい属性は、現在の要素の属性リストの末尾に配置されます。 XPathNavigatorWhen the XPathNavigator is positioned on an element, the new attributes created by the XPathNavigator method are placed at the end of the attribute list of the current element.

  • 新しい属性は、 Close XmlWriterオブジェクトのメソッドが呼び出されるまで挿入されません。The new attributes are not inserted until the Close method of the XmlWriter object is called.

  • 指定された名前空間String.Emptyプレフィックスnullがまたはの場合、新しい属性の名前空間 URI のプレフィックスは、スコープ内の現在の名前空間から取得されます。If the namespace prefix specified is String.Empty or null, the prefix for the namespace URI of the new attribute is obtained from the current namespaces in-scope. 現在のスコープで指定した名前空間 URI に名前空間プレフィックスが割り当てられていない場合は、名前空間プレフィックスが自動的に生成されます。If there is no namespace prefix assigned to the specified namespace URI at the current scope, a namespace prefix is automatically generated. たとえば、 contosoBooks.xmlファイルの既定の名前空間 (xmlns="http://www.contoso.com/books") の要素に新しい属性を作成するには、名前空間プレフィックスString.Emptyと名前空間 URI パラメーターの両方にまたはを指定nullします。For example to create a new attribute on an element in the default namespace of the contosoBooks.xml file, (xmlns="http://www.contoso.com/books"), you specify null or String.Empty for both the namespace prefix and namespace URI parameters. http://www.contoso.com/books名前空間 URI パラメーターとして指定CreateAttributeすると、メソッドによって新しい属性の名前空間プレフィックスが自動生成されます。Specifying http://www.contoso.com/books as the namespace URI parameter will cause the CreateAttribute method to auto generate a namespace prefix for the new attribute.

  • 作成された新しい属性が、要素の名前空間宣言と競合する名前空間ノードである場合は、選択された名前空間プレフィックスが同じスコープの別の名前空間宣言によって使用されているか、選択されたプレフィックスがと同じであることが原因です。要素は別の名前空間 URI にバインドされていますが、例外がスローされます。If the new attribute created is a namespace node which conflicts with a namespace declaration on the element, either because the namespace prefix chosen is used by another namespace declaration at the same scope, or because the prefix chosen is the same as that of the element but is bound to a different namespace URI, an exception is thrown.

  • 返さXmlWriterれるオブジェクトは、属性の作成にのみ使用できます。The XmlWriter object returned may only be used to create attributes. 属性をXmlWriter作成しない他のオブジェクトメソッドを呼び出すと、例外がスローされます。Calling other XmlWriter object methods that do not create attributes throws an exception.

  • メソッドは、 XPathNavigatorの位置には影響しません。 CreateAttributesThe CreateAttributes method does not affect the position of the XPathNavigator.

適用対象