XPathNavigator.PrependChildElement(String, String, String, String) Yöntem

Tanım

Belirtilen değerle belirtilen ad alanı öneki, yerel ad ve ad alanı URI 'SI kullanılarak geçerli düğümün alt düğümleri listesinin başlangıcında yeni bir alt öğe oluşturur.Creates a new child element at the beginning of the list of child nodes of the current node using the namespace prefix, local name, and namespace URI specified with the value specified.

public:
 virtual void PrependChildElement(System::String ^ prefix, System::String ^ localName, System::String ^ namespaceURI, System::String ^ value);
public virtual void PrependChildElement (string prefix, string localName, string namespaceURI, string value);
abstract member PrependChildElement : string * string * string * string -> unit
override this.PrependChildElement : string * string * string * string -> unit
Public Overridable Sub PrependChildElement (prefix As String, localName As String, namespaceURI As String, value As String)

Parametreler

prefix
String

Yeni alt öğenin (varsa) ad alanı öneki.The namespace prefix of the new child element (if any).

localName
String

Yeni alt öğenin yerel adı (varsa).The local name of the new child element (if any).

namespaceURI
String

Yeni alt öğenin (varsa) ad alanı URI 'SI.The namespace URI of the new child element (if any). Empty ve null eşdeğerdir.Empty and null are equivalent.

value
String

Yeni alt öğenin değeri.The value of the new child element. EmptyVeya null geçirilirse boş bir öğe oluşturulur.If Empty or null are passed, an empty element is created.

Özel durumlar

XPathNavigator' Nin bulunduğu geçerli düğüm, yeni bir alt düğümün önüne eklenmesine izin vermiyor.The current node the XPathNavigator is positioned on does not allow a new child node to be prepended.

, XPathNavigator Düzenlemesini desteklemez.The XPathNavigator does not support editing.

Örnekler

Aşağıdaki örnekte, yeni bir pages alt öğe, dosyadaki ilk öğenin alt öğelerinin listesinin başlangıcına getirilir book contosoBooks.xml .In the following example, a new pages child element is prepended to the beginning of the list of child elements of the first book element in the contosoBooks.xml file.

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->PrependChildElement(navigator->Prefix, "pages", navigator->LookupNamespace(navigator->Prefix), "100");

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.PrependChildElement(navigator.Prefix, "pages", navigator.LookupNamespace(navigator.Prefix), "100");

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.PrependChildElement(navigator.Prefix, "pages", navigator.LookupNamespace(navigator.Prefix), "100")

Console.WriteLine(navigator.OuterXml)

Örnek, contosoBooks.xml dosyayı bir giriş olarak alır.The example takes the contosoBooks.xml file as an input.

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

Ön bekleyen bir alt düğüm, geçerli düğüm için alt düğüm listesinin başlangıcına yeni düğümü ekler.Prepending a child node adds the new node to the beginning of the list of child nodes for the current node. Örneğin, bir öğesi için üç alt düğüm olduğunda, prepnode ilk alt düğüm olur.For example, when three child nodes exist for an element, the prepended node becomes the first child node. Alt düğüm yoksa, yeni bir alt düğüm oluşturulur.If no child nodes exist, then a new child node is created.

Ad alanı öneki ve URI değerleri ya da yöntemi kullanılarak elde LookupPrefix edilebilir LookupNamespace .Namespace prefix and URI values can be obtained by using the LookupPrefix or LookupNamespace method. Örneğin, aşağıdaki sözdizimi, kapsam içi ad alanını kullanarak bir alt öğe önüne eklenir xmlns:bk="http://www.contoso.com/books" :For example, the following syntax prepends a child element by using the in-scope namespace xmlns:bk="http://www.contoso.com/books":

navigator.PrependChildElement(navigator.Prefix, "pages", LookupNamespaceURI(navigator.Prefix), String.Empty)  

Bu, yeni alt <bk:pages/> öğesini oluşturur.This creates the new child <bk:pages/> element.

Yöntemi kullanırken göz önünde bulundurmanız gereken önemli notlar aşağıda verilmiştir PrependChildElement .The following are important notes to consider when using the PrependChildElement method.

  • Belirtilen ad alanı öneki veya ise null String.Empty , yeni öğenin ad alanı URI 'sinin ön eki, kapsamdaki geçerli ad alanlarından elde edilir.If the namespace prefix specified is null or String.Empty, then the prefix for the namespace URI of the new element is obtained from the current namespaces in-scope. Geçerli kapsamda belirtilen ad alanı URI 'sine atanmış bir ad alanı öneki yoksa, bir ad alanı öneki otomatik olarak oluşturulur.If there is no namespace prefix assigned to the specified namespace URI at the current scope, then a namespace prefix is automatically generated.

  • PrependChildElementYöntemi yalnızca XPathNavigator bir öğe düğümüne konumlandırıldığında geçerlidir.The PrependChildElement method is valid only when the XPathNavigator is positioned on an element node.

  • PrependChildElementYöntemi, konumunu etkilemez XPathNavigator .The PrependChildElement method does not affect the position of the XPathNavigator.

Şunlara uygulanır