XPathNavigator.PrependChild Yöntem

Tanım

Ad Alanı:: System.Xml.XPath

Bütünleştirilmiş Kodlar:: netstandard.dll, System.Xml.ReaderWriter.dll

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

Bütünleştirilmiş Kod:: System.Xml.ReaderWriter.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

Name	Description
PrependChild()	XmlWriter Geçerli düğümün alt düğümleri 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()

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

XmlWriter Geçerli düğümün alt düğümleri 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üğüm 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 öne eklenmesine izin vermez.

NotSupportedException

XPathNavigator düzenlemeyi desteklemiyor.

Örnekler

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

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, contosoBooks.xml dosyasını giriş olarak alır.

<?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üğüm 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ırken dikkate alınması gereken önemli notlar aşağıdadır PrependChild .

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

Şunlara uygulanır

PrependChild(String)

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

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ün 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 öne eklenmesine izin vermez.

NotSupportedException

XPathNavigator düzenlemeyi desteklemiyor.

XmlException

XML dizesi parametresi iyi biçimlendirilmemiş.

Örnekler

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

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, contosoBooks.xml dosyasını giriş olarak alır.

<?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ırken dikkate alınması gereken önemli notlar aşağıdadır PrependChild .

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

Şunlara uygulanır

PrependChild(XmlReader)

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

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

XmlReader Nesne bir hata durumunda veya kapatıldı.

ArgumentNullException

XmlReader nesne parametresidirnull.

InvalidOperationException

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

NotSupportedException

XPathNavigator düzenlemeyi desteklemiyor.

XmlException

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

Örnekler

Aşağıdaki örnekte, yeni pages bir alt öğe, belirtilen nesne kullanılarak book dosyadaki contosoBooks.xml ilk XmlReader öğenin alt öğeleri listesinin başına 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 = 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, contosoBooks.xml dosyasını giriş olarak alır.

<?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ırken dikkate alınması gereken önemli notlar aşağıdadır PrependChild .

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

Şunlara uygulanır

PrependChild(XPathNavigator)

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

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ılan nesne.

Özel durumlar

ArgumentNullException

XPathNavigator nesne parametresidirnull.

InvalidOperationException

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

NotSupportedException

XPathNavigator düzenlemeyi desteklemiyor.

Örnekler

Aşağıdaki örnekte, yeni pages bir alt öğe, belirtilen nesnede bulunan düğüm kullanılarak dosyadaki book ilk contosoBooks.xml öğenin alt öğeleri listesinin XPathNavigator başına 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 = 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, contosoBooks.xml dosyasını giriş olarak alır.

<?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ırken dikkate alınması gereken önemli notlar aşağıdadır PrependChild .

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

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?