XPathNavigator.SetTypedValue(Object) Metodo

Definizione

Spazio dei nomi:

System.Xml.XPath

Assembly:

System.Xml.ReaderWriter.dll

Origine:

XPathNavigator.cs

Imposta il valore tipizzato del nodo corrente.

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)

Parametri

typedValue

Object

Valore tipizzato del nodo.

Eccezioni

ArgumentException

L'oggetto XPathNavigator non supporta il tipo di oggetto specificato.

ArgumentNullException

Il valore specificato non può essere null.

InvalidOperationException

L'oggetto XPathNavigator non è posizionato in corrispondenza di un nodo elemento o attributo.

NotSupportedException

XPathNavigator non supporta la modifica.

Esempio

Nell'esempio seguente viene usato il SetTypedValue metodo per aggiornare tutti gli elementi nel contosoBooks.xml file usando l'oggetto XmlNamespaceManager per risolvere i price prefissi dello spazio dei nomi nell'espressione 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)

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

Commenti

Quando un oggetto viene creato come risultato di un XmlDocument oggetto di convalida XmlReader dello schema, il valore specificato al SetTypedValue metodo viene verificato sullo schema XSD (XML Schema Definition Language) per il documento XML. Se il valore specificato non è valido in base allo schema per il documento XML, viene generato un XmlSchemaException valore.

Il SetTypedValue metodo è valido solo quando l'oggetto XPathNavigator viene posizionato in un nodo di elemento o attributo.