XPathNavigator による XML データの挿入

XPathNavigator クラスは、XML ドキュメント内に兄弟ノード、子ノード、および属性ノードを挿入するためのメソッドのセットを提供します。 これらのメソッドを使用するには、XPathNavigator オブジェクトが編集可能である必要があります。つまり、その CanEdit プロパティを true にする必要があります。

XML ドキュメントを編集できる XPathNavigator オブジェクトは、XmlDocument クラスの CreateNavigator メソッドによって作成されます。 XPathDocument クラスによって作成される XPathNavigator オブジェクトは読み取り専用で、XPathDocument オブジェクトによって作成される XPathNavigator オブジェクトの編集メソッドを使用しようとすると、NotSupportedException が発生します。

編集可能な XPathNavigator オブジェクトの作成に関する詳細については、「XPathDocument および XmlDocument を使用した XML データの読み取り」を参照してください。

ノードの挿入

XPathNavigator クラスは、XML ドキュメント内に兄弟ノード、子ノード、および属性ノードを挿入するためのメソッドを提供します。 これらのメソッドによって、XPathNavigator オブジェクトの現在位置に関連した異なる場所にノードまたは属性を挿入できます。これらのメソッドについて以下に説明します。

兄弟ノードの挿入

XPathNavigator クラスは、兄弟ノードを挿入する次のメソッドを提供します。

• InsertAfter

• InsertBefore

• InsertElementAfter

• InsertElementBefore

これらのメソッドは XPathNavigator オブジェクトの現在位置にあるノードの前と後に兄弟ノードを挿入します。

InsertAfter および InsertBefore メソッドは、オーバーロードされ、string、XmlReader オブジェクト、または追加する兄弟ノードをパラメーターとして含む XPathNavigator オブジェクトを受け取ります。 両方のメソッドは、兄弟ノードの挿入に使用される XmlWriter オブジェクトも返します。

InsertElementAfter および InsertElementBefore メソッドは、パラメーターとして指定された名前空間プレフィックス、ローカル名、名前空間 URI、および値を使用して XPathNavigator オブジェクトの現在位置にあるノードの前と後に、1 つの兄弟ノードを挿入します。

次の例では、新しい pages 要素が contosoBooks.xml ファイル内の最初の book 要素の price 子要素の前に挿入されます。

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

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

navigator.InsertBefore("<pages>100</pages>")

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

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

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

navigator.InsertBefore("<pages>100</pages>");

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

XmlDocument^ document = gcnew XmlDocument();
document->Load("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();

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

navigator->InsertBefore("<pages>100</pages>");

navigator->MoveToParent();
Console::WriteLine(navigator->OuterXml);

この例は、contosoBooks.xml ファイルを入力として使用します。

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="https://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>

InsertAfter、InsertBefore、InsertElementAfter、および InsertElementBefore メソッドの詳細については、XPathNavigator クラスのリファレンス ドキュメントを参照してください。

子ノードの挿入

XPathNavigator クラスは、子ノードを挿入する次のメソッドを提供します。

• AppendChild

• PrependChild

• AppendChildElement

• PrependChildElement

これらのメソッドは、XPathNavigator オブジェクトの現在位置にあるノードの一連の子ノードの最後と最初に、子ノードを追加します。

「兄弟ノードの挿入」のメソッドと同様、AppendChild および PrependChild メソッドは、string、XmlReader オブジェクト、または追加する子ノードをパラメーターとして含む XPathNavigator オブジェクトを受け取ります。 両方のメソッドは、子ノードの挿入に使用される XmlWriter オブジェクトも返します。

また、「兄弟ノードの挿入」のメソッドと同様、AppendChildElement および PrependChildElement メソッドは、パラメーターとして指定された名前空間プレフィックス、ローカル名、名前空間 URI、および値を使用して XPathNavigator オブジェクトの現在位置にあるノードの一連の子ノードの最初と最後に 1 つの子ノードを追加します。

次の例では、新しい pages 子要素が contosoBooks.xml ファイル内の最初の book 要素の一連の子要素に追加されます。

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

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

navigator.AppendChild("<pages>100</pages>")

Console.WriteLine(navigator.OuterXml)

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

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

navigator.AppendChild("<pages>100</pages>");

Console.WriteLine(navigator.OuterXml);

XmlDocument^ document = gcnew XmlDocument();
document->Load("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();

navigator->MoveToChild("bookstore", "https://www.contoso.com/books");
navigator->MoveToChild("book", "https://www.contoso.com/books");

navigator->AppendChild("<pages>100</pages>");

Console::WriteLine(navigator->OuterXml);

この例は、contosoBooks.xml ファイルを入力として使用します。

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="https://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>

AppendChild、PrependChild、AppendChildElement、および PrependChildElement メソッドの詳細については、XPathNavigator クラスのリファレンス ドキュメントを参照してください。

属性ノードの挿入

XPathNavigator クラスは、属性ノードを挿入する次のメソッドを提供します。

• CreateAttribute

• CreateAttributes

これらのメソッドは XPathNavigator オブジェクトの現在位置にある要素ノードに属性ノードを挿入します。 CreateAttribute メソッドは、パラメーターとして指定された名前空間プレフィックス、ローカル名、名前空間 URI、および値を使用して XPathNavigator オブジェクトの現在位置にある要素ノードに、属性ノードを作成します。 CreateAttributes メソッドは、属性ノードの挿入に使用される XmlWriter オブジェクトも返します。

次の例では、CreateAttributes メソッドから返された XmlWriter オブジェクトを使用して、新しい discount および currency 属性が contosoBooks.xml ファイル内の最初の book 要素の price 子要素に作成されます。

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

navigator.MoveToChild("bookstore", "https://www.contoso.com/books")
navigator.MoveToChild("book", "https://www.contoso.com/books")
navigator.MoveToChild("price", "https://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)

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

navigator.MoveToChild("bookstore", "https://www.contoso.com/books");
navigator.MoveToChild("book", "https://www.contoso.com/books");
navigator.MoveToChild("price", "https://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 = gcnew XmlDocument();
document->Load("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();

navigator->MoveToChild("bookstore", "https://www.contoso.com/books");
navigator->MoveToChild("book", "https://www.contoso.com/books");
navigator->MoveToChild("price", "https://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);

この例は、contosoBooks.xml ファイルを入力として使用します。

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="https://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>

CreateAttribute および CreateAttributes メソッドの詳細については、XPathNavigator クラスのリファレンス ドキュメントを参照してください。

ノードのコピー

別の XML ドキュメントの内容を使用して XML ドキュメントを作成する場合があります。 XPathNavigator クラスおよび XmlWriter クラスは、既存の XmlReader オブジェクトまたは XPathNavigator オブジェクトから XmlDocument オブジェクトへノードをコピーできます。

XPathNavigator クラスの AppendChild、PrependChild、InsertBefore、および InsertAfter メソッドにはすべて、パラメーターとして XPathNavigator オブジェクトまたは XmlReader オブジェクトの受け取りが可能なオーバーロードがあります。

XmlWriter クラスの WriteNode メソッドには、XmlNode、XmlReader、または XPathNavigator オブジェクトの受け取りが可能なオーバーロードがあります。

次の例では、あるドキュメントからすべての book 要素を別のドキュメントにコピーします。

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

navigator.MoveToChild("bookstore", String.Empty)

Dim newBooks As XPathDocument = New XPathDocument("newBooks.xml")
Dim newBooksNavigator As XPathNavigator = newBooks.CreateNavigator()

Dim nav As XPathNavigator
For Each nav in newBooksNavigator.SelectDescendants("book", "", false)
    navigator.AppendChild(nav)
Next

document.Save("newBooks.xml");

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

navigator.MoveToChild("bookstore", String.Empty);
            
XPathDocument newBooks = new XPathDocument("newBooks.xml");
XPathNavigator newBooksNavigator = newBooks.CreateNavigator();

foreach (XPathNavigator nav in newBooksNavigator.SelectDescendants("book", "", false))
{
    navigator.AppendChild(nav);
}

document.Save("newBooks.xml");

値の挿入

XPathNavigator クラスは、XmlDocument オブジェクトにノードの値を挿入する SetValue および SetTypedValue メソッドを提供しています。

型指定されていない値の挿入

SetValue メソッドは、パラメーターとして渡された型指定されていない string 値を挿入するだけです。このパラメーターは、XPathNavigator オブジェクトの現在位置にあるノードの値です。 値に型は設定されず、スキーマ情報が使用可能な場合でも、ノードの型に対して新しい値が有効どうかを検証せずに挿入されます。

SetValue メソッドを使用して contosoBooks.xml フィァイル内のすべての price 要素を更新する例を次に示します。

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

Dim manager As XmlNamespaceManager = New XmlNamespaceManager(navigator.NameTable)
manager.AddNamespace("bk", "https://www.contoso.com/books")

For Each nav As XPathNavigator In navigator.Select("//bk:price", manager)
    If nav.Value = "11.99" Then
        nav.SetValue("12.99")
    End If
Next

Console.WriteLine(navigator.OuterXml)

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

XmlNamespaceManager manager = new XmlNamespaceManager(navigator.NameTable);
manager.AddNamespace("bk", "https://www.contoso.com/books");

foreach (XPathNavigator nav in navigator.Select("//bk:price", manager))
{
    if (nav.Value == "11.99")
    {
        nav.SetValue("12.99");
    }
}

Console.WriteLine(navigator.OuterXml);

XmlDocument^ document = gcnew XmlDocument();
document->Load("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();

XmlNamespaceManager^ manager = gcnew XmlNamespaceManager(navigator->NameTable);
manager->AddNamespace("bk", "https://www.contoso.com/books");

for each (XPathNavigator^ nav in navigator->Select("//bk:price", manager))
{
    if(nav->Value == "11.99")
    {
        nav->SetValue("12.99");
    }
}

Console::WriteLine(navigator->OuterXml);

この例は、contosoBooks.xml ファイルを入力として使用します。

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="https://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>

型指定された値の挿入

ノードの型が W3C XML スキーマの単純型の場合、SetTypedValue メソッドによって挿入される新しい値は、値の設定前に、単純型のファセットに対してチェックされます。 新しい値がノードの型に対して有効でない場合 (たとえば、型が xs:positiveInteger の要素に、値 -1 を設定するような場合)、例外が返されます。

次の例では、contosoBooks.xml ファイル内の最初の book 要素の price 要素の値を DateTime 値に変更しようとしています。 price 要素の XML スキーマ型は、contosoBooks.xsd ファイル内で xs:decimal として定義されているため、結果は例外になります。

Dim settings As XmlReaderSettings = New XmlReaderSettings()
settings.Schemas.Add("https://www.contoso.com/books", "contosoBooks.xsd")
settings.ValidationType = ValidationType.Schema

Dim reader As XmlReader = XmlReader.Create("contosoBooks.xml", settings)

Dim document As XmlDocument = New XmlDocument()
document.Load(reader)
Dim navigator As XPathNavigator = document.CreateNavigator()

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

navigator.SetTypedValue(DateTime.Now)

XmlReaderSettings settings = new XmlReaderSettings();
settings.Schemas.Add("https://www.contoso.com/books", "contosoBooks.xsd");
settings.ValidationType = ValidationType.Schema;

XmlReader reader = XmlReader.Create("contosoBooks.xml", settings);

XmlDocument document = new XmlDocument();
document.Load(reader);
XPathNavigator navigator = document.CreateNavigator();

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

navigator.SetTypedValue(DateTime.Now);

この例は、contosoBooks.xml ファイルを入力として使用します。

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="https://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>

また、contosoBooks.xsd ファイルも入力として使用します。

<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="https://www.contoso.com/books" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="bookstore">
        <xs:complexType>
            <xs:sequence>
                <xs:element maxOccurs="unbounded" name="book">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="title" type="xs:string" />
                            <xs:element name="author">
                                <xs:complexType>
                                    <xs:sequence>
                                        <xs:element minOccurs="0" name="name" type="xs:string" />
                                        <xs:element minOccurs="0" name="first-name" type="xs:string" />
                                        <xs:element minOccurs="0" name="last-name" type="xs:string" />
                                    </xs:sequence>
                                </xs:complexType>
                            </xs:element>
                            <xs:element name="price" type="xs:decimal" />
                        </xs:sequence>
                        <xs:attribute name="genre" type="xs:string" use="required" />
                        <xs:attribute name="publicationdate" type="xs:date" use="required" />
                        <xs:attribute name="ISBN" type="xs:string" use="required" />
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

InnerXml および OuterXml プロパティ

XPathNavigator クラスの InnerXml および OuterXml プロパティは、XPathNavigator オブジェクトの現在位置にある XML マークアップを変更します。

InnerXml プロパティは、与えられた XML string の解析済みの内容を使用して XPathNavigator オブジェクトの現在位置にある子ノードの XML マークアップを変更します。 同様に、OuterXml プロパティは、XPathNavigator オブジェクトの現在位置にある子ノードと現在のノード自体の XML マークアップを変更します。

このトピックで説明したメソッドに加えて、InnerXml プロパティと OuterXml プロパティは、XML ドキュメントからノードに値を挿入するために使用できます。 InnerXml プロパティと OuterXml プロパティを使用してノードと値を挿入する方法の詳細については「XpathNavigator による XML データの変更」を参照してください。

名前空間と xml:lang の競合

パラメーターとして XmlReader オブジェクトを受け取る XPathNavigator クラスの InsertBefore、InsertAfter、AppendChild、および PrependChild メソッドを使用して XML データを挿入する場合、名前空間のスコープと xml:lang 宣言に関連する競合が発生する可能性があります。

発生する可能性のある名前空間の競合は次のとおりです。

• XmlReader オブジェクトのコンテキスト内のスコープに名前空間があり、プレフィックスから名前空間 URI へのマッピングが XPathNavigator オブジェクトのコンテキスト内にない場合、新たに挿入されたノードに関する新しい名前空間宣言が追加されます。

• XmlReader オブジェクトのコンテキスト内と XPathNavigator オブジェクトのコンテキスト内の両方のスコープに同じ名前空間 URI があるが、両方のコンテキスト内で別のプレフィックスにマップされている場合、XmlReader オブジェクトからのプレフィックスと名前空間 URI を使用して、新たに挿入されたノードに対する新しい名前空間宣言が追加されます。

• XmlReader オブジェクトのコンテキスト内と XPathNavigator オブジェクトのコンテキスト内の両方のスコープに同じ名前空間プレフィックスがあるが、両方のコンテキスト内で別の名前空間 URI にマップされている場合、新たに挿入されたノードに対する新しい名前空間宣言が追加され、XmlReader オブジェクトからの名前空間 URI を使用してそのプレフィックスを再宣言します。

• XmlReader オブジェクトのコンテキスト内と XPathNavigator オブジェクトのコンテキスト内の両方で、プレフィックスと名前空間 URI が同じ場合、新たに挿入されたノードに対する新しい名前空間宣言は追加されません。

メモ
上記の説明は、プレフィックスとして空の string (たとえば、既定の名前空間宣言) を使用した名前空間宣言にも適用されます。

発生する可能性のある xml:lang の競合は次のとおりです。

• xml:lang 属性が XmlReader オブジェクトのコンテキスト内のスコープにあるが、XPathNavigator オブジェクトのコンテキスト内にはない場合、XmlReader オブジェクトから受け取った値を持つ xml:lang 属性が、新たに挿入されたノードに対して追加されます。

• xml:lang 属性が XmlReader オブジェクトのコンテキスト内と XPathNavigator オブジェクトのコンテキスト内の両方のスコープにあるが、それぞれの値が異なる場合、XmlReader オブジェクトから受け取った値を持つ xml:lang 属性が、新たに挿入されたノードに対して追加されます。

• xml:lang 属性が XmlReader オブジェクトのコンテキスト内と XPathNavigator オブジェクトのコンテキスト内の両方のスコープにあるが、それぞれの値が同じ場合、新たに挿入されたノードに対して新しい xml:lang 属性は追加されません。

• xml:lang 属性が XPathNavigator オブジェクトのコンテキスト内のスコープにあるが、XmlReader オブジェクトのコンテキスト内にはない場合、新たに挿入されたノードに対して xml:lang 属性は追加されません。

XmlWriter によるノードの挿入

「ノードと値の挿入」に記載されている兄弟ノード、子ノード、および属性ノードの挿入に使用されるメソッドはオーバーロードされます。 XPathNavigator クラスの InsertAfter、InsertBefore、AppendChild、PrependChild、および CreateAttributes メソッドは、ノードの挿入に使用される XmlWriter オブジェクトを返します。

サポートされていない XmlWriter メソッド

XPath データ モデルとドキュメント オブジェクト モデル (DOM) には相違点があるため、XmlWriter クラスによる XML ドキュメントへの情報の書き込みで使用されるメソッドのすべてが XPathNavigator クラスによってサポートされているわけではありません。

XPathNavigator クラスによってサポートされない XmlWriter クラス メソッドについて次の表で説明します。

XmlWriter クラスに関する詳細については、XmlWriter クラスのリファレンス ドキュメントを参照してください。

複数の XmlWriter オブジェクト

1 つ以上の開いた XmlWriter オブジェクトを使用して、XML ドキュメントの異なる部分を指す複数の XPathNavigator オブジェクトを持つことができます。 複数の XmlWriter オブジェクトは、単一スレッドのシナリオで許可されサポートされます。

以下は、複数の XmlWriter オブジェクト使用時の重要な注意事項です。

• それぞれの XmlWriter オブジェクトの Close メソッドが呼び出されるときに、XmlWriter オブジェクトによって書き込まれる XML フラグメントが XML ドキュメントに追加されます。 その時点まで、XmlWriter オブジェクトは、まとまっていないフラグメントを書き込んでいます。 XML ドキュメントに対する操作が実行される場合、Close の呼び出し前に XmlWriter オブジェクトによって書き込まれているフラグメントは影響を受けません。

• 特定の XML サブツリー上に、開いた XmlWriter オブジェクトがあり、そのサブツリーが削除された場合、XmlWriter オブジェクトが引き続きそのサブツリーに追加する可能性があります。 サブツリーは単に削除済みフラグメントになります。

• XML ドキュメント内の同じ位置で、複数の XmlWriter オブジェクトが開かれた場合、XmlWriter オブジェクトが開かれた順序ではなく、それらが閉じられる順序で XML ドキュメントにそれらが追加されます。

次の例では、XmlDocument オブジェクトを作成し、XPathNavigator オブジェクトを作成した後、PrependChild メソッドによって返される XmlWriter オブジェクトを使用して、books.xml ファイル内に最初の book 構造体を作成します。 この例は、それを book.xml ファイルとして保存します。

Dim document As XmlDocument = New XmlDocument()
Dim navigator As XPathNavigator = document.CreateNavigator()

Using writer As XmlWriter = navigator.PrependChild()

    writer.WriteStartElement("bookstore")
    writer.WriteStartElement("book")
    writer.WriteAttributeString("genre", "autobiography")
    writer.WriteAttributeString("publicationdate", "1981-03-22")
    writer.WriteAttributeString("ISBN", "1-861003-11-0")
    writer.WriteElementString("title", "The Autobiography of Benjamin Franklin")
    writer.WriteStartElement("author")
    writer.WriteElementString("first-name", "Benjamin")
    writer.WriteElementString("last-name", "Franklin")
    writer.WriteElementString("price", "8.99")
    writer.WriteEndElement()
    writer.WriteEndElement()
    writer.WriteEndElement()

End Using

document.Save("book.xml")

XmlDocument document = new XmlDocument();
XPathNavigator navigator = document.CreateNavigator();

using (XmlWriter writer = navigator.PrependChild())
{
    writer.WriteStartElement("bookstore");
    writer.WriteStartElement("book");
    writer.WriteAttributeString("genre", "autobiography");
    writer.WriteAttributeString("publicationdate", "1981-03-22");
    writer.WriteAttributeString("ISBN", "1-861003-11-0");
    writer.WriteElementString("title", "The Autobiography of Benjamin Franklin");
    writer.WriteStartElement("author");
    writer.WriteElementString("first-name", "Benjamin");
    writer.WriteElementString("last-name", "Franklin");
    writer.WriteElementString("price", "8.99");
    writer.WriteEndElement();
    writer.WriteEndElement();
    writer.WriteEndElement();
}
document.Save("book.xml");

XML ドキュメントの保存

ここに記載されているメソッドによる XmlDocument オブジェクトに対する変更の保存は、XmlDocument クラスのメソッドを使用して実行されます。 XmlDocument オブジェクトに対する変更の保存に関する詳細については、「ドキュメントの保存と書き込み」を参照してください。

参照

参照

XmlDocument

XPathDocument

XPathNavigator

概念

XPath データ モデルを使用した XML データの処理

XpathNavigator による XML データの変更

XPathNavigator による XML データの削除