XPathNavigator.SetValue(String) Metódus

Definíció

Névtér:

System.Xml.XPath

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XPathNavigator.cs

Az aktuális csomópont értékét állítja be.

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éterek

value

String

A csomópont új értéke.

Kivételek

ArgumentNullException

Az értékparaméter a következő null: .

InvalidOperationException

A XPathNavigator rendszer a gyökércsomóponton, egy névtércsomóponton vagy a megadott értéken van elhelyezve.

NotSupportedException

Ez XPathNavigator nem támogatja a szerkesztést.

Példák

A következő példában a metódus a SetValue fájl összes price elemének frissítésére szolgál az contosoBooks.xml objektummal az XmlNamespaceManager XPath-kifejezés névtér-előtagjainak feloldásához.

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)

A példa bemenetként használja a contosoBooks.xml fájlt.

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

Megjegyzések

• Ha az XPathNavigator elemcsomópont összetett tartalommal (gyermekelemekkel) van elhelyezve, a SetValue metódus meghívása a gyermekelemeket egy szövegcsomópontra cseréli, amely az új sztringértéket tartalmazza.

• A SetValue metódus nem tudja frissíteni a gyökércsomópontot vagy a névtércsomópontokat.