Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale
Questo argomento non è stato ancora valutato - Valuta questo argomento

Metodo XPathNavigator.InsertElementBefore

Crea un nuovo elemento di pari livello prima del nodo corrente utilizzando il prefisso dello spazio dei nomi, il nome locale e l'URI dello spazio dei nomi specificati con il valore specificato.

Spazio dei nomi:  System.Xml.XPath
Assembly:  System.Xml (in System.Xml.dll)
public virtual void InsertElementBefore(
	string prefix,
	string localName,
	string namespaceURI,
	string value
)

Parametri

prefix
Tipo: System.String
Prefisso dello spazio dei nomi del nuovo elemento figlio, se presente.
localName
Tipo: System.String
Nome locale del nuovo elemento figlio, se presente.
namespaceURI
Tipo: System.String
URI dello spazio dei nomi del nuovo elemento figlio, se presente. Empty e null si equivalgono.
value
Tipo: System.String
Valore del nuovo elemento figlio. Se viene passato Empty o null, viene creato un elemento vuoto.
EccezioneCondizione
InvalidOperationException

La posizione dell'oggetto XPathNavigator non consente l'inserimento di un nuovo nodo di pari livello prima del nodo corrente.

NotSupportedException

L'oggetto XPathNavigator non può essere modificato.

È possibile ottenere i valori del prefisso degli spazi dei nomi e i valori URI tramite il metodo LookupPrefix o LookupNamespace. Ad esempio, nella sintassi seguente viene inserito un elemento di pari livello utilizzando lo spazio dei nomi xmlns:bk="http://www.contoso.com/books" nell'ambito:

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

Questo crea il nuovo elemento <bk:pages/> di pari livello.

Di seguito sono riportate note importanti relative all'utilizzo del metodo InsertElementBefore.

  • Se il prefisso dello spazio dei nomi specificato è null o String.Empty, il prefisso per l'URI dello spazio dei nomi del nuovo elemento si ottiene dagli spazi dei nomi correnti nell'ambito. Se non è assegnato alcun prefisso dello spazio dei nomi all'URI dello spazio dei nomi specificato nell'ambito corrente, viene automaticamente generato un prefisso dello spazio dei nomi.

  • Il metodo InsertElementBefore è valido solo quando l'oggetto XPathNavigator è posizionato in corrispondenza di un nodo elemento, di testo, istruzione di elaborazione o commento.

  • Il metodo InsertElementBefore non influisce sulla posizione dell'oggetto XPathNavigator.

Nell'esempio riportato di seguito viene inserito un nuovo elemento pages prima dell'elemento price figlio del primo elemento book nel file contosoBooks.xml.


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.MoveToChild("price", "http://www.contoso.com/books");

navigator.InsertElementBefore(navigator.Prefix, "pages", navigator.LookupNamespace(navigator.Prefix), "100");

navigator.MoveToParent();
Console.WriteLine(navigator.OuterXml);


Nell'esempio il file contosoBooks.xml viene utilizzato come 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>


.NET Framework

Supportato in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Il documento è risultato utile?
(1500 caratteri rimanenti)

Aggiunte alla community

AGGIUNGI
© 2013 Microsoft. Tutti i diritti riservati.