XPathNavigator.SetTypedValue(Object) Metoda

Definicja

Przestrzeń nazw:

System.Xml.XPath

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.XPath.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Ustawia typizowane wartości bieżącego węzła.

public:
 virtual void SetTypedValue(System::Object ^ typedValue);

public virtual void SetTypedValue (object typedValue);

abstract member SetTypedValue : obj -> unit
override this.SetTypedValue : obj -> unit

Public Overridable Sub SetTypedValue (typedValue As Object)

Parametry

typedValue

Object

Nowa typowana wartość węzła.

Wyjątki

ArgumentException

Obiekt XPathNavigator nie obsługuje typu określonego obiektu.

ArgumentNullException

Określona wartość nie może być null.

InvalidOperationException

Element XPathNavigator nie jest umieszczony w węźle elementu lub atrybutu.

NotSupportedException

Element XPathNavigator nie obsługuje edycji.

Przykłady

W poniższym przykładzie SetTypedValue metoda jest używana do aktualizowania wszystkich price elementów w contosoBooks.xml pliku przy użyciu XmlNamespaceManager obiektu w celu rozpoznawania prefiksów przestrzeni nazw w wyrażeniu XPath.

XmlReaderSettings^ settings = gcnew XmlReaderSettings();
settings->Schemas->Add("http://www.contoso.com/books", "contosoBooks.xsd");
settings->ValidationType = ValidationType::Schema;

XmlReader^ reader = XmlReader::Create("contosoBooks.xml", settings);
XmlDocument^ document = gcnew XmlDocument();
document->Load(reader);

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");

Decimal^ price = gcnew Decimal(19.99);
navigator->SetTypedValue(price);

navigator->MoveToParent();
Console::WriteLine(navigator->OuterXml);

XmlReaderSettings settings = new XmlReaderSettings();
settings.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd");
settings.ValidationType = ValidationType.Schema;

XmlReader reader = XmlReader.Create("contosoBooks.xml", settings);
XmlDocument document = new XmlDocument();
document.Load(reader);

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");

Decimal price = 19.99M;
navigator.SetTypedValue(price);

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

Dim settings As XmlReaderSettings = New XmlReaderSettings()
settings.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd")
settings.ValidationType = ValidationType.Schema

Dim reader As XmlReader = XmlReader.Create("contosoBooks.xml", settings)
Dim document As XmlDocument = New XmlDocument()
document.Load(reader)

Dim navigator As XPathNavigator = 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")

Dim price As New Decimal(19.99)
navigator.SetTypedValue(price)

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

W przykładzie plik jest contosoBooks.xml pobierany jako dane wejściowe.

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

Uwagi

XmlDocument Po utworzeniu obiektu w wyniku sprawdzania poprawności XmlReader schematu wartość określona SetTypedValue dla metody jest weryfikowana względem schematu języka XSD (XML Schema Definition Language) dla dokumentu XML. Jeśli określona wartość jest nieprawidłowa zgodnie ze schematem dokumentu XML, XmlSchemaException jest zgłaszana wartość .

Metoda jest prawidłowa SetTypedValue tylko wtedy, gdy XPathNavigator element jest umieszczony w węźle elementu lub atrybutu.