XPathNavigator.InsertBefore 方法

參考

定義

命名空間:: System.Xml.XPath

組件:: System.Xml.ReaderWriter.dll

組件:: System.Xml.XPath.dll

組件:: System.Xml.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

在目前選取的節點之前建立新的同層級節點。

多載

InsertBefore()	傳回 XmlWriter 物件，此物件用來在目前選取的節點之前建立新的同層級節點。
InsertBefore(String)	使用指定的 XML 字串，在目前選取的節點之前建立新的同層級節點。
InsertBefore(XmlReader)	使用指定之 XmlReader 物件的 XML 內容，在目前選取的節點之前建立新的同層級節點。
InsertBefore(XPathNavigator)	使用所指定 XPathNavigator 中的節點，在目前所選節點之前建立新的同層級節點。

InsertBefore()

Source:: XPathNavigator.cs

Source:: XPathNavigator.cs

Source:: XPathNavigator.cs

傳回 XmlWriter 物件，此物件用來在目前選取的節點之前建立新的同層級節點。

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

public virtual System.Xml.XmlWriter InsertBefore ();

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

Public Overridable Function InsertBefore () As XmlWriter

傳回

XmlWriter

XmlWriter 物件，用來在目前選取的節點之前，建立新的同層級節點。

例外狀況

InvalidOperationException

XPathNavigator 的位置不允許在目前節點之前插入的新同層級節點。

NotSupportedException

XPathNavigator 不支援編輯。

範例

在下列範例中，會使用 XmlWriter 方法所傳回 InsertBefore 的物件，在檔案中 contosoBooks.xml 第一 book 個專案的子專案之前 price 插入新 pages 元素。

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->InsertBefore();
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.InsertBefore();
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.InsertBefore()
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>

備註

以下是使用 InsertBefore 方法時要考慮的重要注意事項。

在呼叫物件的方法 XmlWriter 之前 Close ，不會插入新的同層級節點。
只有在位於專案、文字、處理指示或批註節點的時 XPathNavigator ，方法 InsertBefore 才有效。
方法 InsertBefore 不會影響的位置 XPathNavigator 。

適用於

InsertBefore(String)

Source:: XPathNavigator.cs

Source:: XPathNavigator.cs

Source:: XPathNavigator.cs

使用指定的 XML 字串，在目前選取的節點之前建立新的同層級節點。

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

public virtual void InsertBefore (string newSibling);

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

Public Overridable Sub InsertBefore (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->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", "http://www.contoso.com/books");
navigator.MoveToChild("book", "http://www.contoso.com/books");
navigator.MoveToChild("price", "http://www.contoso.com/books");

navigator.InsertBefore("<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.InsertBefore("<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 節點的字串為 InsertBefore("<book/>") 。在目前節點的文位元組點為 InsertBefore("book") 之前插入文字「book」的字串。如果 XML 字串包含多個節點，則會新增所有節點。

以下是使用 InsertBefore 方法時要考慮的重要注意事項。

只有在位於專案、文字、處理指示或批註節點的時 XPathNavigator ，方法 InsertBefore 才有效。
方法 InsertBefore 不會影響的位置 XPathNavigator 。

適用於

InsertBefore(XmlReader)

Source:: XPathNavigator.cs

Source:: XPathNavigator.cs

Source:: XPathNavigator.cs

使用指定之 XmlReader 物件的 XML 內容，在目前選取的節點之前建立新的同層級節點。

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

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

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

Public Overridable Sub InsertBefore (newSibling As XmlReader)

參數

newSibling: XmlReader

位於新的同層級節點之 XML 資料上的 XmlReader 物件。

例外狀況

ArgumentException

XmlReader 物件處於錯誤狀態或已關閉。

ArgumentNullException

XmlReader 物件參數為 null。

InvalidOperationException

XPathNavigator 的位置不允許在目前節點之前插入的新同層級節點。

NotSupportedException

XPathNavigator 不支援編輯。

XmlException

XmlReader 物件參數的 XML 內容語式不正確。

範例

在下列範例中，會使用 XmlReader 指定的物件，在檔案中 contosoBooks.xml 第一 book 個元素的子專案之前 price 插入新 pages 元素。指定 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->InsertBefore(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.InsertBefore(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.InsertBefore(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>

備註

以下是使用 InsertBefore 方法時要考慮的重要注意事項。

XmlReader如果物件位於 XML 節點序列上，則會加入序列中的所有節點。
只有在位於專案、文字、處理指示或批註節點的時 XPathNavigator ，方法 InsertBefore 才有效。
方法 InsertBefore 不會影響的位置 XPathNavigator 。

適用於

InsertBefore(XPathNavigator)

Source:: XPathNavigator.cs

Source:: XPathNavigator.cs

Source:: XPathNavigator.cs

使用所指定 XPathNavigator 中的節點，在目前所選節點之前建立新的同層級節點。

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

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

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

Public Overridable Sub InsertBefore (newSibling As XPathNavigator)

參數

newSibling: XPathNavigator

XPathNavigator 物件，位於要以新的同層級節點形式加入的節點上。

例外狀況

ArgumentNullException

XPathNavigator 物件參數為 null。

InvalidOperationException

XPathNavigator 的位置不允許在目前節點之前插入的新同層級節點。

NotSupportedException

XPathNavigator 不支援編輯。

範例

在下列範例中，會使用指定之物件中包含的 XPathNavigator 節點，在檔案中 contosoBooks.xml 第一 book 個專案的子專案之前 price 插入新 pages 元素。指定 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->InsertBefore(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.InsertBefore(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.InsertBefore(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>

備註

以下是使用 InsertBefore 方法時要考慮的重要注意事項。

XPathNavigator如果物件位於 XML 節點序列上，則會加入序列中的所有節點。
只有在位於專案、文字、處理指示或批註節點的時 XPathNavigator ，方法 InsertBefore 才有效。
方法 InsertBefore 不會影響的位置 XPathNavigator 。

適用於

XPathNavigator.InsertBefore 方法

定義

多載

InsertBefore()

傳回

例外狀況

範例

備註

適用於

InsertBefore(String)

參數

例外狀況

範例

備註

適用於

InsertBefore(XmlReader)

參數

例外狀況

範例

備註

適用於

InsertBefore(XPathNavigator)

參數

例外狀況

範例

備註

適用於

意見反應

其他資源