XPathNavigator.SetValue(String) Yöntem

Tanım

Ad Alanı:

System.Xml.XPath

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XPathNavigator.cs

Geçerli düğümün değerini ayarlar.

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)

Parametreler

value

String

Düğümün yeni değeri.

Özel durumlar

ArgumentNullException

değer parametresidir null.

InvalidOperationException

XPathNavigator kök düğümde, ad alanı düğümünde konumlandırıldı veya belirtilen değer geçersiz.

NotSupportedException

XPathNavigator düzenlemeyi desteklemiyor.

Örnekler

Aşağıdaki örnekte yöntemi, SetValue XPath ifadesindeki price ad alanı ön eklerini çözümlemek için nesnesini kullanarak contosoBooks.xml dosyadaki tüm XmlNamespaceManager öğeleri güncelleştirmek için kullanılır.

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)

Ö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

• karmaşık içeriğe XPathNavigator (alt öğeler) sahip bir öğe düğümünde konumlandırılırsa, yöntemini çağırmak SetValue alt öğelerin yerini yeni dize değerini içeren bir metin düğümüyle değiştirir.

• SetValue yöntemi kök düğümü veya ad alanı düğümlerini güncelleştiremiyor.