XPathNavigator.PrependChild Yöntem

Başvuru

Tanım

Ad Alanı:: System.Xml.XPath

Bütünleştirilmiş Kod:: System.Xml.ReaderWriter.dll

Bütünleştirilmiş Kod:: System.Xml.XPath.dll

Bütünleştirilmiş Kod:: System.Xml.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Geçerli düğümün alt düğüm listesinin başında yeni bir alt düğüm oluşturur.

Aşırı Yüklemeler

PrependChild()	XmlWriter Geçerli düğümün alt düğüm listesinin başında yeni bir alt düğüm oluşturmak için kullanılan nesneyi döndürür.
PrependChild(String)	Belirtilen XML dizesini kullanarak geçerli düğümün alt düğümleri listesinin başında yeni bir alt düğüm oluşturur.
PrependChild(XmlReader)	Belirtilen nesnenin XML içeriğini XmlReader kullanarak geçerli düğümün alt düğüm listesinin başında yeni bir alt düğüm oluşturur.
PrependChild(XPathNavigator)	Belirtilen nesnedeki düğümleri kullanarak geçerli düğümün alt düğüm listesinin başında yeni bir alt düğüm XPathNavigator oluşturur.

PrependChild()

XmlWriter Geçerli düğümün alt düğüm listesinin başında yeni bir alt düğüm oluşturmak için kullanılan nesneyi döndürür.

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

Döndürülenler

XmlWriter

XmlWriter Geçerli düğümün alt düğümleri listesinin başında yeni bir alt düğüm oluşturmak için kullanılan nesne.

Özel durumlar

InvalidOperationException

öğesinin XPathNavigator konumlandırıldığı geçerli düğüm, yeni bir alt düğümün ön ekine eklenmesine izin vermez.

NotSupportedException

düzenlemeyi XPathNavigator desteklemez.

Örnekler

Aşağıdaki örnekte, yönteminden PrependChild döndürülen nesnesi kullanılarak XmlWriter dosyadaki ilk book öğenin alt öğeleri listesinin başına yeni pages bir alt öğe contosoBooks.xml eklenir.

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)

Örnek, dosyayı giriş olarak alır 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>

Açıklamalar

Alt düğümün önceden eklenmesi, yeni düğümü geçerli düğüm için alt düğümler listesinin başına ekler. Örneğin, bir öğe için üç alt düğüm mevcut olduğunda, önceden eklenen düğüm ilk alt düğüm olur. Alt düğüm yoksa yeni bir alt düğüm oluşturulur.

Yöntemi kullanılırken PrependChild dikkate alınması gereken önemli notlar aşağıdadır.

Nesnenin yöntemi XmlWriter çağrılana Close kadar yeni alt düğüm eklenmez.
PrependChild yöntemi yalnızca öğesi düğümünde konumlandırıldığında XPathNavigator geçerlidir.
PrependChild yöntemi, konumunu XPathNavigatoretkilemez.

Şunlara uygulanır

PrependChild(String)

Belirtilen XML dizesini kullanarak geçerli düğümün alt düğümleri listesinin başında yeni bir alt düğüm oluşturur.

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)

Parametreler

newChild: String

Yeni alt düğüm için XML veri dizesi.

Özel durumlar

ArgumentNullException

XML dizesi parametresidir null.

InvalidOperationException

öğesinin XPathNavigator konumlandırıldığı geçerli düğüm, yeni bir alt düğümün ön ekine eklenmesine izin vermez.

NotSupportedException

düzenlemeyi XPathNavigator desteklemez.

XmlException

XML dize parametresi iyi biçimlendirilmemiş.

Örnekler

Aşağıdaki örnekte, dosyadaki ilk book öğenin alt öğeleri listesinin başına yeni pages bir alt öğe contosoBooks.xml eklenir.

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)

Örnek, dosyayı giriş olarak alır 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>

Açıklamalar

Yeni bir öğe düğümü oluşturmak için, XML dizesi parametresine tüm XML söz dizimini ekleyin. Yeni book düğümün dizesi şeklindedir PrependChild("<book/>"). Geçerli düğümün metin düğümüne "book" metnini ekleme dizesidir PrependChild("book"). XML dizesi birden çok düğüm içeriyorsa, tüm düğümler eklenir.

Yöntemi kullanılırken PrependChild dikkate alınması gereken önemli notlar aşağıdadır.

PrependChild yöntemi yalnızca öğesi düğümünde konumlandırıldığında XPathNavigator geçerlidir.
PrependChild yöntemi, konumunu XPathNavigatoretkilemez.

Şunlara uygulanır

PrependChild(XmlReader)

Belirtilen nesnenin XML içeriğini XmlReader kullanarak geçerli düğümün alt düğüm listesinin başında yeni bir alt düğüm oluşturur.

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)

Parametreler

newChild: XmlReader

XmlReader Yeni alt düğüm için XML verilerine konumlandırılmış bir nesne.

Özel durumlar

ArgumentException

Nesne XmlReader bir hata durumunda veya kapalı.

ArgumentNullException

XmlReader nesne parametresidirnull.

InvalidOperationException

öğesinin XPathNavigator konumlandırıldığı geçerli düğüm, yeni bir alt düğümün ön ekine eklenmesine izin vermez.

NotSupportedException

düzenlemeyi XPathNavigator desteklemez.

XmlException

Nesne parametresinin XmlReader XML içeriği iyi biçimlendirilmemiş.

Örnekler

Aşağıdaki örnekte, belirtilen nesne kullanılarak XmlReader dosyadaki ilk book öğenin alt öğeleri listesinin başına yeni pages bir alt öğe contosoBooks.xml eklenir. Ad http://www.contoso.com/books alanı, yeni alt öğenin XML belgesiyle aynı ad alanı kullanılarak eklenmesi için belirtilir.

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)

Örnek, dosyayı giriş olarak alır 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>

Açıklamalar

Yöntemi kullanılırken PrependChild dikkate alınması gereken önemli notlar aşağıdadır.

XmlReader Nesne bir XML düğümleri dizisi üzerine konumlandırılırsa, dizideki tüm düğümler eklenir.
PrependChild yöntemi yalnızca öğesi düğümünde konumlandırıldığında XPathNavigator geçerlidir.
PrependChild yöntemi, konumunu XPathNavigatoretkilemez.

Şunlara uygulanır

PrependChild(XPathNavigator)

Belirtilen nesnedeki düğümleri kullanarak geçerli düğümün alt düğüm listesinin başında yeni bir alt düğüm XPathNavigator oluşturur.

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)

Parametreler

newChild: XPathNavigator

XPathNavigator Yeni alt düğüm olarak eklenecek düğümde konumlandırılmış bir nesne.

Özel durumlar

ArgumentNullException

XPathNavigator nesne parametresidirnull.

InvalidOperationException

üzerinde konumlandırıldığı geçerli düğüm XPathNavigator , yeni bir alt düğümün öne eklenmesine izin vermez.

NotSupportedException

düzenlemeyi XPathNavigator desteklemiyor.

Örnekler

Aşağıdaki örnekte, belirtilen nesnede bulunan XPathNavigator düğüm kullanılarak dosyadaki ilk book öğenin alt öğeleri listesinin başına yeni pages bir alt öğe contosoBooks.xml eklenir. Ad http://www.contoso.com/books alanı, yeni alt öğenin XML belgesiyle aynı ad alanı kullanılarak önceden eklenmesi için belirtilir.

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)

Örnek, dosyayı giriş olarak alır 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>

Açıklamalar

Yöntemi kullanılırken PrependChild dikkate alınması gereken önemli notlar aşağıdadır.

XPathNavigator Nesne bir XML düğümleri dizisi üzerine konumlandırılırsa, dizideki tüm düğümler eklenir.
PrependChild yöntemi yalnızca öğesi düğümünde konumlandırıldığında XPathNavigator geçerlidir.
PrependChild yöntemi, konumunu XPathNavigatoretkilemez.

Şunlara uygulanır

Aracılığıyla paylaş

XPathNavigator.PrependChild Yöntem

Tanım

Aşırı Yüklemeler

PrependChild()

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

PrependChild(String)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

PrependChild(XmlReader)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

PrependChild(XPathNavigator)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

Ek kaynaklar