XPathNavigator.PrependChild Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Xml.XPath

Zestaw:: System.Xml.ReaderWriter.dll

Zestaw:: System.Xml.XPath.dll

Zestaw:: System.Xml.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Tworzy nowy węzeł podrzędny na początku listy węzłów podrzędnych bieżącego węzła.

Przeciążenia

PrependChild()	XmlWriter Zwraca obiekt użyty do utworzenia nowego węzła podrzędnego na początku listy węzłów podrzędnych bieżącego węzła.
PrependChild(String)	Tworzy nowy węzeł podrzędny na początku listy węzłów podrzędnych bieżącego węzła przy użyciu określonego ciągu XML.
PrependChild(XmlReader)	Tworzy nowy węzeł podrzędny na początku listy węzłów podrzędnych bieżącego węzła przy użyciu zawartości XML określonego XmlReader obiektu.
PrependChild(XPathNavigator)	Tworzy nowy węzeł podrzędny na początku listy węzłów podrzędnych bieżącego węzła przy użyciu węzłów w XPathNavigator określonym obiekcie.

PrependChild()

XmlWriter Zwraca obiekt użyty do utworzenia nowego węzła podrzędnego na początku listy węzłów podrzędnych bieżącego węzła.

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

public virtual System.Xml.XmlWriter PrependChild ();

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

Public Overridable Function PrependChild () As XmlWriter

Zwraca

XmlWriter

Obiekt XmlWriter używany do tworzenia nowego węzła podrzędnego na początku listy węzłów podrzędnych bieżącego węzła.

Wyjątki

InvalidOperationException

Bieżący węzeł, na XPathNavigator który jest umieszczony, nie zezwala na dołączanie nowego węzła podrzędnego.

NotSupportedException

Element XPathNavigator nie obsługuje edycji.

Przykłady

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

XmlWriter^ pages = navigator->PrependChild();
pages->WriteElementString("pages", "100");
pages->Close();

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

XmlWriter pages = navigator.PrependChild();
pages.WriteElementString("pages", "100");
pages.Close();

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

Dim pages As XmlWriter = navigator.PrependChild()
pages.WriteElementString("pages", "100")
pages.Close()

Console.WriteLine(navigator.OuterXml)

W przykładzie plik jest contosoBooks.xml pobierany jako dane wejściowe.

<?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>

Uwagi

Wstępne dodawanie węzła podrzędnego do początku listy węzłów podrzędnych dla bieżącego węzła. Na przykład gdy istnieją trzy węzły podrzędne dla elementu, wstępnie utworzony węzeł staje się pierwszym węzłem podrzędnym. Jeśli nie istnieją żadne węzły podrzędne, zostanie utworzony nowy węzeł podrzędny.

Poniżej przedstawiono ważne uwagi, które należy wziąć pod uwagę podczas korzystania z PrependChild metody .

Nowy węzeł podrzędny nie jest wstawiany do momentu Close wywołania metody XmlWriter obiektu.
Metoda jest prawidłowa PrependChild tylko wtedy, gdy XPathNavigator element znajduje się w węźle elementu.
Metoda PrependChild nie ma wpływu na położenie XPathNavigatorobiektu .

Dotyczy

PrependChild(String)

Tworzy nowy węzeł podrzędny na początku listy węzłów podrzędnych bieżącego węzła przy użyciu określonego ciągu XML.

public:
 virtual void PrependChild(System::String ^ newChild);

public virtual void PrependChild (string newChild);

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

Public Overridable Sub PrependChild (newChild As String)

Parametry

newChild: String

Ciąg danych XML dla nowego węzła podrzędnego.

Wyjątki

ArgumentNullException

Parametr ciągu XML to null.

InvalidOperationException

Bieżący węzeł, na XPathNavigator który jest umieszczony, nie zezwala na dołączanie nowego węzła podrzędnego.

NotSupportedException

Element XPathNavigator nie obsługuje edycji.

XmlException

Parametr ciągu XML nie jest poprawnie sformułowany.

Przykłady

W poniższym przykładzie nowy pages element podrzędny jest poprzedzany na początku listy elementów podrzędnych pierwszego book elementu w contosoBooks.xml pliku.

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->PrependChild("<pages>100</pages>");

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.PrependChild("<pages>100</pages>");

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.PrependChild("<pages>100</pages>")

Console.WriteLine(navigator.OuterXml)

W przykładzie plik jest contosoBooks.xml pobierany jako dane wejściowe.

<?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>

Uwagi

Aby utworzyć nowy węzeł elementu, uwzględnij całą składnię XML w parametrze ciągu XML. Ciąg nowego węzła book to PrependChild("<book/>"). Ciąg dołączania tekstu "book" do węzła tekstowego bieżącego węzła to PrependChild("book"). Jeśli ciąg XML zawiera wiele węzłów, zostaną dodane wszystkie węzły.

Poniżej przedstawiono ważne uwagi, które należy wziąć pod uwagę podczas korzystania z PrependChild metody .

Metoda jest prawidłowa PrependChild tylko wtedy, gdy XPathNavigator element znajduje się w węźle elementu.
Metoda PrependChild nie ma wpływu na położenie XPathNavigatorobiektu .

Dotyczy

PrependChild(XmlReader)

Tworzy nowy węzeł podrzędny na początku listy węzłów podrzędnych bieżącego węzła przy użyciu zawartości XML określonego XmlReader obiektu.

public:
 virtual void PrependChild(System::Xml::XmlReader ^ newChild);

public virtual void PrependChild (System.Xml.XmlReader newChild);

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

Public Overridable Sub PrependChild (newChild As XmlReader)

Parametry

newChild: XmlReader

XmlReader Obiekt umieszczony w danych XML dla nowego węzła podrzędnego.

Wyjątki

ArgumentException

Obiekt XmlReader jest w stanie błędu lub jest zamknięty.

ArgumentNullException

XmlReader Parametr obiektu to null.

InvalidOperationException

Bieżący węzeł, na XPathNavigator który jest umieszczony, nie zezwala na dołączanie nowego węzła podrzędnego.

NotSupportedException

Element XPathNavigator nie obsługuje edycji.

XmlException

Zawartość XML parametru XmlReader obiektu nie jest poprawnie sformułowana.

Przykłady

W poniższym przykładzie nowy pages element podrzędny jest poprzedzany na początku listy elementów podrzędnych pierwszego book elementu w contosoBooks.xml pliku przy użyciu określonego XmlReader obiektu. http://www.contoso.com/books Przestrzeń nazw jest określana tak, aby nowy element podrzędny był poprzedzany przy użyciu tej samej przestrzeni nazw co dokument 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");

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

navigator->PrependChild(pages);

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

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

navigator.PrependChild(pages);

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

Dim pages As XmlReader = XmlReader.Create(New StringReader("<pages xmlns='http://www.contoso.com/books'>100</pages>"))

navigator.PrependChild(pages)

Console.WriteLine(navigator.OuterXml)

W przykładzie plik jest contosoBooks.xml pobierany jako dane wejściowe.

<?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>

Uwagi

Poniżej przedstawiono ważne uwagi, które należy wziąć pod uwagę podczas korzystania z PrependChild metody .

XmlReader Jeśli obiekt jest umieszczony w sekwencji węzłów XML, zostaną dodane wszystkie węzły w sekwencji.
Metoda jest prawidłowa PrependChild tylko wtedy, gdy XPathNavigator element znajduje się w węźle elementu.
Metoda PrependChild nie ma wpływu na położenie XPathNavigatorobiektu .

Dotyczy

PrependChild(XPathNavigator)

Tworzy nowy węzeł podrzędny na początku listy węzłów podrzędnych bieżącego węzła przy użyciu węzłów w XPathNavigator określonym obiekcie.

public:
 virtual void PrependChild(System::Xml::XPath::XPathNavigator ^ newChild);

public virtual void PrependChild (System.Xml.XPath.XPathNavigator newChild);

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

Public Overridable Sub PrependChild (newChild As XPathNavigator)

Parametry

newChild: XPathNavigator

Obiekt XPathNavigator umieszczony w węźle, który ma zostać dodany jako nowy węzeł podrzędny.

Wyjątki

ArgumentNullException

XPathNavigator Parametr obiektu to null.

InvalidOperationException

Bieżący węzeł, na XPathNavigator który jest umieszczony, nie zezwala na dołączanie nowego węzła podrzędnego.

NotSupportedException

Element XPathNavigator nie obsługuje edycji.

Przykłady

W poniższym przykładzie nowy pages element podrzędny jest poprzedzany na początku listy elementów podrzędnych pierwszego book elementu w contosoBooks.xml pliku przy użyciu węzła zawartego XPathNavigator w określonym obiekcie. http://www.contoso.com/books Przestrzeń nazw jest określana tak, aby nowy element podrzędny był poprzedzany przy użyciu tej samej przestrzeni nazw co dokument 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");

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

navigator->PrependChild(childNodesNavigator);

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

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

navigator.PrependChild(childNodesNavigator);

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

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.PrependChild(childNodesNavigator)

Console.WriteLine(navigator.OuterXml)

W przykładzie plik jest contosoBooks.xml pobierany jako dane wejściowe.

<?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>

Uwagi

Poniżej przedstawiono ważne uwagi, które należy wziąć pod uwagę podczas korzystania z PrependChild metody .

XPathNavigator Jeśli obiekt jest umieszczony w sekwencji węzłów XML, zostaną dodane wszystkie węzły w sekwencji.
Metoda jest prawidłowa PrependChild tylko wtedy, gdy XPathNavigator element znajduje się w węźle elementu.
Metoda PrependChild nie ma wpływu na położenie XPathNavigatorobiektu .

Dotyczy

XPathNavigator.PrependChild Metoda

Definicja

Przeciążenia

PrependChild()

Zwraca

Wyjątki

Przykłady

Uwagi

Dotyczy

PrependChild(String)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

PrependChild(XmlReader)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

PrependChild(XPathNavigator)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

Dodatkowe zasoby