XPathNavigator.InsertAfter Метод

Ссылка

Определение

Пространство имен:: System.Xml.XPath

Сборка:: System.Xml.ReaderWriter.dll

Сборка:: System.Xml.XPath.dll

Сборка:: System.Xml.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Создает после текущего выбранного узла новый узел того же уровня.

Перегрузки

InsertAfter(XPathNavigator)	Создает новый сестринский узел после выбранного в данный момент узла, используя узлы, содержащиеся в указанном объекте XPathNavigator.
InsertAfter(XmlReader)	Создает новый сестринский узел после выбранного в текущий момент узла, используя содержимое XML указанного объекта XmlReader.
InsertAfter()	Возвращает объект XmlWriter, используемый для создания нового сестринского узла после текущего выбранного узла.
InsertAfter(String)	Создает после текущего выбранного узла новый узел того же уровня, используя заданную строку XML.

InsertAfter(XPathNavigator)

Создает новый сестринский узел после выбранного в данный момент узла, используя узлы, содержащиеся в указанном объекте XPathNavigator.

public:
 virtual void InsertAfter(System::Xml::XPath::XPathNavigator ^ newSibling);

public virtual void InsertAfter (System.Xml.XPath.XPathNavigator newSibling);

abstract member InsertAfter : System.Xml.XPath.XPathNavigator -> unit
override this.InsertAfter : System.Xml.XPath.XPathNavigator -> unit

Public Overridable Sub InsertAfter (newSibling As XPathNavigator)

Параметры

newSibling: XPathNavigator

Объект XPathNavigator, расположенный в узле, который следует добавить как новый сестринский узел.

Исключения

ArgumentNullException

Объект XPathNavigator имеет параметр null.

InvalidOperationException

Положение объекта XPathNavigator не допускает вставку нового сестринского узла после текущего узла.

NotSupportedException

Объект XPathNavigator не поддерживает редактирование.

Примеры

В следующем примере новый pages элемент вставляется после price дочернего элемента первого book элемента в contosoBooks.xml файле с помощью узла, содержащегося в указанном объекте XPathNavigator . Пространство http://www.contoso.com/books имен указывается таким образом, чтобы новый элемент того же уровня вставлялся с использованием того же пространства имен, что и XML-документ.

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");

XmlDocument^ childNodes = gcnew XmlDocument();
childNodes->Load(gcnew StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));
XPathNavigator^ childNodesNavigator = childNodes->CreateNavigator();

navigator->InsertAfter(childNodesNavigator);

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");

XmlDocument childNodes = new XmlDocument();
childNodes.Load(new StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));
XPathNavigator childNodesNavigator = childNodes.CreateNavigator();

navigator.InsertAfter(childNodesNavigator);

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 childNodes As XmlDocument = New XmlDocument()
childNodes.Load(New StringReader("<pages xmlns='http://www.contoso.com/books'>100</pages>"))
Dim childNodesNavigator As XPathNavigator = childNodes.CreateNavigator()

navigator.InsertAfter(childNodesNavigator)

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>

XmlReader Если объект размещается по последовательности УЗЛОВ XML, добавляются все узлы в последовательности.
Метод InsertAfter действителен только в том случае, если XPathNavigator он располагается на элементе, тексте, инструкции по обработке или узле комментария.
Метод InsertAfter не влияет на положение объекта XPathNavigator.

Применяется к

InsertAfter(XmlReader)

Создает новый сестринский узел после выбранного в текущий момент узла, используя содержимое XML указанного объекта XmlReader.

public:
 virtual void InsertAfter(System::Xml::XmlReader ^ newSibling);

public virtual void InsertAfter (System.Xml.XmlReader newSibling);

abstract member InsertAfter : System.Xml.XmlReader -> unit
override this.InsertAfter : System.Xml.XmlReader -> unit

Public Overridable Sub InsertAfter (newSibling As XmlReader)

Параметры

newSibling: XmlReader

Объект XmlReader, расположенный в XML-данных для нового сестринского узла.

Исключения

ArgumentException

Объект XmlReader находится в состоянии ошибки или закрыт.

ArgumentNullException

Объект XmlReader имеет параметр null.

InvalidOperationException

Положение объекта XPathNavigator не допускает вставку нового сестринского узла после текущего узла.

NotSupportedException

Объект XPathNavigator не поддерживает редактирование.

XmlException

XML-содержимое параметра объекта XmlReader сформировано некорректно.

Примеры

В следующем примере новый pages элемент вставляется после price дочернего элемента первого book элемента в contosoBooks.xml файле с использованием указанного XmlReader объекта. Пространство http://www.contoso.com/books имен указывается таким образом, чтобы новый элемент того же уровня вставлялся с использованием того же пространства имен, что и XML-документ.

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");

XmlReader^ pages = XmlReader::Create(gcnew StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));

navigator->InsertAfter(pages);

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");

XmlReader pages = XmlReader.Create(new StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));

navigator.InsertAfter(pages);

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 pages As XmlReader = XmlReader.Create(New StringReader("<pages xmlns='http://www.contoso.com/books'>100</pages>"))

navigator.InsertAfter(pages)

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>

XmlReader Если объект размещается по последовательности УЗЛОВ XML, добавляются все узлы в последовательности.
Метод InsertAfter действителен только в том случае, если XPathNavigator он располагается на элементе, тексте, инструкции по обработке или узле комментария.
Метод InsertAfter не влияет на положение объекта XPathNavigator.

Применяется к

InsertAfter()

Возвращает объект XmlWriter, используемый для создания нового сестринского узла после текущего выбранного узла.

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

public virtual System.Xml.XmlWriter InsertAfter ();

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

Public Overridable Function InsertAfter () As XmlWriter

Возвращаемое значение

XmlWriter

Объект XmlWriter, используемый для создания нового сестринского узла после текущего выбранного узла.

Исключения

InvalidOperationException

Положение объекта XPathNavigator не допускает вставку нового сестринского узла после текущего узла.

NotSupportedException

Объект XPathNavigator не поддерживает редактирование.

Примеры

В следующем примере новый pages элемент вставляется после price дочернего элемента первого book элемента в contosoBooks.xml файле с помощью XmlWriter объекта, возвращаемого методом InsertAfter .

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^ pages = navigator->InsertAfter();
pages->WriteElementString("pages", "100");
pages->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 pages = navigator.InsertAfter();
pages.WriteElementString("pages", "100");
pages.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 pages As XmlWriter = navigator.InsertAfter()
pages.WriteElementString("pages", "100")
pages.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>

Новый одноуровневый узел не вставляется до Close вызова метода XmlWriter объекта.
Метод InsertAfter действителен только в том случае, если XPathNavigator он располагается на элементе, тексте, инструкции по обработке или узле комментария.
Метод InsertAfter не влияет на положение объекта XPathNavigator.

Применяется к

InsertAfter(String)

Создает после текущего выбранного узла новый узел того же уровня, используя заданную строку XML.

public:
 virtual void InsertAfter(System::String ^ newSibling);

public virtual void InsertAfter (string newSibling);

abstract member InsertAfter : string -> unit
override this.InsertAfter : string -> unit

Public Overridable Sub InsertAfter (newSibling As String)

Параметры

newSibling: String

Строка данных XML для нового узла того же уровня.

Исключения

ArgumentNullException

Параметр строки XML — null.

InvalidOperationException

Положение объекта XPathNavigator не допускает вставку нового сестринского узла после текущего узла.

NotSupportedException

Объект XPathNavigator не поддерживает редактирование.

XmlException

Неправильный формат параметра строки XML.

Примеры

В следующем примере новый pages элемент вставляется после price дочернего элемента первого book элемента в contosoBooks.xml файле.

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");

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

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");

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

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")

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

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>

Чтобы создать узел элемента, включите весь синтаксис XML в параметр строки XML. Строка для нового book узла .InsertAfter("<book/>") Строка для вставки текста "book" после текстового узла текущего узла InsertAfter("book"). Если строка XML содержит несколько узлов, добавляются все узлы.

Ниже приведены важные примечания, которые следует учитывать при использовании InsertAfter метода.

Метод InsertAfter действителен только в том случае, если XPathNavigator он располагается на элементе, тексте, инструкции по обработке или узле комментария.
Метод InsertAfter не влияет на положение объекта XPathNavigator.

Применяется к

XPathNavigator.InsertAfter Метод

Определение

Перегрузки

InsertAfter(XPathNavigator)

Параметры

Исключения

Примеры

Комментарии

Применяется к

InsertAfter(XmlReader)

Параметры

Исключения

Примеры

Комментарии

Применяется к

InsertAfter()

Возвращаемое значение

Исключения

Примеры

Комментарии

Применяется к

InsertAfter(String)

Параметры

Исключения

Примеры

Комментарии

Применяется к

Дополнительные ресурсы