XPathNavigator.SetValue(String) Méthode

Définition

Espace de noms:

System.Xml.XPath

Assembly:

System.Xml.ReaderWriter.dll

Source:

XPathNavigator.cs

Définit la valeur du nœud actuel.

public:
 virtual void SetValue(System::String ^ value);

public virtual void SetValue (string value);

abstract member SetValue : string -> unit
override this.SetValue : string -> unit

Public Overridable Sub SetValue (value As String)

Paramètres

value

String

Nouvelle valeur du nœud.

Exceptions

ArgumentNullException

Le paramètre de valeur est null.

InvalidOperationException

Le XPathNavigator est placé sur le nœud racine, un nœud d'espace de noms, ou la valeur spécifiée n'est pas valide.

NotSupportedException

Le XPathNavigator ne prend pas en charge la modification.

Exemples

Dans l’exemple suivant, la SetValue méthode est utilisée pour mettre à jour tous les price éléments du fichier à l’aide contosoBooks.xml de l’objet XmlNamespaceManager afin de résoudre les préfixes d’espace de noms dans l’expression XPath.

XmlDocument^ document = gcnew XmlDocument();
document->Load("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();

XmlNamespaceManager^ manager = gcnew XmlNamespaceManager(navigator->NameTable);
manager->AddNamespace("bk", "http://www.contoso.com/books");

for each (XPathNavigator^ nav in navigator->Select("//bk:price", manager))
{
    if(nav->Value == "11.99")
    {
        nav->SetValue("12.99");
    }
}

Console::WriteLine(navigator->OuterXml);

XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

XmlNamespaceManager manager = new XmlNamespaceManager(navigator.NameTable);
manager.AddNamespace("bk", "http://www.contoso.com/books");

foreach (XPathNavigator nav in navigator.Select("//bk:price", manager))
{
    if (nav.Value == "11.99")
    {
        nav.SetValue("12.99");
    }
}

Console.WriteLine(navigator.OuterXml);

Dim document As XmlDocument = New XmlDocument()
document.Load("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

Dim manager As XmlNamespaceManager = New XmlNamespaceManager(navigator.NameTable)
manager.AddNamespace("bk", "http://www.contoso.com/books")

For Each nav As XPathNavigator In navigator.Select("//bk:price", manager)
    If nav.Value = "11.99" Then
        nav.SetValue("12.99")
    End If
Next

Console.WriteLine(navigator.OuterXml)

L'exemple prend le fichier contosoBooks.xml comme entrée.

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

Remarques

• Si est positionné sur un nœud d’élément avec du contenu complexe (éléments enfants), l’appel de XPathNavigator la SetValue méthode remplace les éléments enfants par un nœud de texte contenant la nouvelle valeur de chaîne.

• La SetValue méthode ne peut pas mettre à jour le nœud racine ou les nœuds d’espace de noms.