Udostępnij za pośrednictwem


XPathNavigator.PrependChild Metoda

Definicja

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

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

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 XmlWriter obiektu zwróconego PrependChild z metody .

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 .

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

Parametr ciągu XML to null.

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

Element XPathNavigator nie obsługuje edycji.

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

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.

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 .

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

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

XmlReader Parametr obiektu to null.

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

Element XPathNavigator nie obsługuje edycji.

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

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 .

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

XPathNavigator Parametr obiektu to null.

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

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

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 .

Dotyczy