XPathExpression Classe

Definizione

Spazio dei nomi:

System.Xml.XPath

Assembly:

System.Xml.ReaderWriter.dll

Source:

XPathExpr.cs

Fornisce una classe tipizzata che rappresenta un’espressione XPath compilata.

public ref class XPathExpression abstract

public abstract class XPathExpression

type XPathExpression = class

Public MustInherit Class XPathExpression

Ereditarietà

Object

XPathExpression

Esempio

Nell'esempio seguente viene illustrato come utilizzare il tipo restituito XPath per determinare come elaborare l'espressione XPath.

public ref class Sample
{
public:
   static void Evaluate( XPathExpression^ expr, XPathNavigator^ nav )
   {
      XPathNodeIterator^ i = nav->Select(expr);
      switch ( expr->ReturnType )
      {
         case XPathResultType::Number:
            Console::WriteLine( nav->Evaluate( expr ) );
            break;

         case XPathResultType::NodeSet:
            while ( i->MoveNext() )
                        Console::WriteLine( i->Current );
            break;

         case XPathResultType::Boolean:
            if ( *safe_cast<bool^>(nav->Evaluate( expr )) )
                        Console::WriteLine( "True!" );
            break;

         case XPathResultType::String:
            Console::WriteLine( nav->Evaluate( expr ) );
            break;
      }
   }

};

int main()
{
   XPathDocument^ doc = gcnew XPathDocument( "contosoBooks.xml" );
   XPathNavigator^ nav = doc->CreateNavigator();
   XPathExpression^ expr1 = nav->Compile( ".//price/text()*10" ); // Returns a number.

   XPathExpression^ expr2 = nav->Compile( "bookstore/book/price" ); // Returns a nodeset.

   Sample^ MySample = gcnew Sample;
   MySample->Evaluate( expr1, nav );
   MySample->Evaluate( expr2, nav );
}

using System;
using System.Xml;
using System.Xml.XPath;

public class XPathExpressionExample
{
    public static void Main()
    {
        XPathDocument document = new XPathDocument("contosoBooks.xml");
        XPathNavigator navigator = document.CreateNavigator();

        XPathExpression expression1 = XPathExpression.Compile(".//bk:price/text()*10"); // Returns a number.
        XPathExpression expression2 = XPathExpression.Compile("bk:bookstore/bk:book/bk:price"); // Returns a nodeset.

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

        expression1.SetContext(manager);
        expression2.SetContext(manager);

        Evaluate(expression1, navigator);
        Evaluate(expression2, navigator);
    }

    public static void Evaluate(XPathExpression expression, XPathNavigator navigator)
    {
        switch (expression.ReturnType)
        {
            case XPathResultType.Number:
                Console.WriteLine(navigator.Evaluate(expression));
                break;

            case XPathResultType.NodeSet:
                XPathNodeIterator nodes = navigator.Select(expression);
                while (nodes.MoveNext())
                {
                    Console.WriteLine(nodes.Current.ToString());
                }
                break;

            case XPathResultType.Boolean:
                if ((bool)navigator.Evaluate(expression))
                    Console.WriteLine("True!");
                break;

            case XPathResultType.String:
                Console.WriteLine(navigator.Evaluate(expression));
                break;
        }
    }
}

Imports System.Xml
Imports System.Xml.XPath

Public Class XPathExpressionExample

    Public Shared Sub Main()
        Dim document As XPathDocument = New XPathDocument("contosoBooks.xml")
        Dim navigator As XPathNavigator = document.CreateNavigator()

        Dim expression1 As XPathExpression = XPathExpression.Compile(".//bk:price/text()*10")  ' Returns a number.
        Dim expression2 As XPathExpression = XPathExpression.Compile("bk:bookstore/bk:book/bk:price")  ' Returns a nodeset.

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

        expression1.SetContext(manager)
        expression2.SetContext(manager)

        Evaluate(expression1, navigator)
        Evaluate(expression2, navigator)

    End Sub

    Public Shared Sub Evaluate(ByVal expression As XPathExpression, ByVal navigator As XPathNavigator)

        Select Case expression.ReturnType
            Case XPathResultType.Number
                Console.WriteLine(navigator.Evaluate(expression))
                Exit Sub

            Case XPathResultType.NodeSet
                Dim nodes As XPathNodeIterator = navigator.Select(expression)
                While nodes.MoveNext()
                    Console.WriteLine(nodes.Current.ToString())
                End While

            Case XPathResultType.Boolean
                If CType(navigator.Evaluate(expression), Boolean) Then
                    Console.WriteLine("True!")
                End If

            Case XPathResultType.String
                Console.WriteLine(navigator.Evaluate(expression))
        End Select

    End Sub
End Class

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

Questa classe viene restituita come risultato del Compile metodo della XPathNavigator classe . È un parametro per i Evaluatemetodi , Matches, Selecte SelectSingleNode della XPathNavigator classe .

Note per gli implementatori

Quando si eredita dalla XPathExpression classe , è necessario eseguire l'override dei membri seguenti:

• AddSort(Object, IComparer)AddSort(Object, XmlSortOrder, XmlCaseOrder, String, XmlDataType)

• Clone()

• Expression

• ReturnType

• SetContext(IXmlNamespaceResolver)

• SetContext(XmlNamespaceManager).

Proprietà

Expression	Quando sottoposto a override in una classe derivata, ottiene una rappresentazione in formato string di XPathExpression.
ReturnType	Quando è sottoposto a override in una classe derivata, ottiene il tipo di risultato dell'espressione XPath.

Metodi

AddSort(Object, IComparer)	Quando sottoposto a override in una classe derivata, ordina i nodi selezionati mediante l'espressione XPath in base all'oggetto IComparer specificato.
AddSort(Object, XmlSortOrder, XmlCaseOrder, String, XmlDataType)	Quando è sottoposto a override in una classe derivata, ordina i nodi selezionati dall'espressione XPath in base ai parametri specificati.
Clone()	Quando sottoposto a override in una classe derivata, restituisce un clone di questo XPathExpression.
Compile(String)	Compila l'espressione XPath specificata e restituisce un oggetto XPathExpression che rappresenta l'espressione XPath.
Compile(String, IXmlNamespaceResolver)	Compila l'espressione XPath specificata, con l'oggetto IXmlNamespaceResolver specificato per la risoluzione dello spazio dei nomi, e restituisce un oggetto XPathExpression che rappresenta l'espressione XPath.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
SetContext(IXmlNamespaceResolver)	Quando è sottoposto a override in una classe derivata, specifica l'oggetto IXmlNamespaceResolver da usare per la risoluzione dello spazio dei nomi.
SetContext(XmlNamespaceManager)	Quando è sottoposto a override in una classe derivata, specifica l'oggetto XmlNamespaceManager da usare per la risoluzione dello spazio dei nomi.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)