XPathNavigator.InsertAfter Метод

Определение

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

Сборки:: netstandard.dll, System.Xml.ReaderWriter.dll

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

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

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

Сборка:: netstandard.dll

Важно!

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

Создает новый одноуровневый узел после выбранного в данный момент узла.

Перегрузки

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

InsertAfter(XPathNavigator)

Исходный код:: XPathNavigator.cs

Исходный код:: XPathNavigator.cs

Исходный код:: XPathNavigator.cs

Исходный код:: XPathNavigator.cs

Исходный код:: XPathNavigator.cs

Создает новый одноуровневый узел после выбранного в данный момент узла с помощью узлов в указанном объекте 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 = 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)

Исходный код:: XPathNavigator.cs

Исходный код:: XPathNavigator.cs

Исходный код:: XPathNavigator.cs

Исходный код:: XPathNavigator.cs

Исходный код:: XPathNavigator.cs

Создает новый одноуровневый узел после выбранного в данный момент узла с использованием 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 = 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()

Исходный код:: XPathNavigator.cs

Исходный код:: XPathNavigator.cs

Исходный код:: XPathNavigator.cs

Исходный код:: XPathNavigator.cs

Исходный код:: XPathNavigator.cs

Возвращает объект, используемый 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 = 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)

Исходный код:: XPathNavigator.cs

Исходный код:: XPathNavigator.cs

Исходный код:: XPathNavigator.cs

Исходный код:: XPathNavigator.cs

Исходный код:: XPathNavigator.cs

Создает новый одноуровневый узел после выбранного в данный момент узла с помощью указанной 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 = 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/>"). Строка для вставки текстового "книги" после текстового узла текущего узла InsertAfter("book"). Если XML-строка содержит несколько узлов, добавляются все узлы.

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

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

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

Кері байланыс

Бет пайдалы болды ма?

XPathNavigator.InsertAfter Метод

Определение

Перегрузки

InsertAfter(XPathNavigator)

Параметры

Исключения

Примеры

Комментарии

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

InsertAfter(XmlReader)

Параметры

Исключения

Примеры

Комментарии

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

InsertAfter()

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

Исключения

Примеры

Комментарии

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

InsertAfter(String)

Параметры

Исключения

Примеры

Комментарии

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