XPathExpression Klasse

Definition

Stellt eine typisierte Klasse bereit, die einen kompilierten XPath-Ausdruck darstellt.Provides a typed class that represents a compiled XPath expression.

public ref class XPathExpression abstract
public abstract class XPathExpression
type XPathExpression = class
Public MustInherit Class XPathExpression
Vererbung
XPathExpression

Beispiele

Das folgende Beispiel zeigt, wie der XPath-Rückgabetyp verwendet wird, um zu bestimmen, wie der XPath-Ausdruck verarbeitet wird.The following example shows how to use the XPath return type to determine how to process the XPath expression.

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

In diesem Beispiel wird die Datei contosoBooks.xml als Eingabe verwendet.The example takes the contosoBooks.xml file as 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>  

Hinweise

Diese Klasse wird als Ergebnis der- Compile Methode der-Klasse zurückgegeben XPathNavigator .This class is returned as the result of the Compile method of the XPathNavigator class. Es handelt sich um einen Parameter für die Evaluate Matches Methoden,, Select und SelectSingleNode der- XPathNavigator Klasse.It is a parameter to the Evaluate, Matches, Select, and SelectSingleNode methods of the XPathNavigator class.

Hinweise für Ausführende

Wenn Sie von der- XPathExpression Klasse erben, müssen Sie die folgenden Member überschreiben:When you inherit from the XPathExpression class, you must override the following members:

Eigenschaften

Expression

Ruft beim Überschreiben in einer abgeleiteten Klasse eine string-Darstellung von XPathExpression ab.When overridden in a derived class, gets a string representation of the XPathExpression.

ReturnType

Ruft beim Überschreiben in einer abgeleiteten Klasse den Ergebnistyp des XPath-Ausdrucks ab.When overridden in a derived class, gets the result type of the XPath expression.

Methoden

AddSort(Object, IComparer)

Sortiert beim Überschreiben in einer abgeleiteten Klasse die vom XPath-Ausdruck ausgewählten Knoten anhand des angegebenen IComparer-Objekts.When overridden in a derived class, sorts the nodes selected by the XPath expression according to the specified IComparer object.

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

Sortiert beim Überschreiben in einer abgeleiteten Klasse die Knoten, die vom XPath-Ausdruck anhand der bereitgestellten Parameter ausgewählt wurden.When overridden in a derived class, sorts the nodes selected by the XPath expression according to the supplied parameters.

Clone()

Gibt beim Überschreiben in einer abgeleiteten Klasse einen Klon dieser XPathExpression zurück.When overridden in a derived class, returns a clone of this XPathExpression.

Compile(String)

Kompiliert den angegebenen XPath-Ausdruck und gibt ein XPathExpressionObjekt zurück, das den XPath-Ausdruck darstellt.Compiles the XPath expression specified and returns an XPathExpression object representing the XPath expression.

Compile(String, IXmlNamespaceResolver)

Kompiliert den angegebenen XPath-Ausdruck, wobei das IXmlNamespaceResolver-Objekt für die Namespaceauflösung angegeben ist, und gibt ein XPathExpression-Objekt zurück, das den XPath-Ausdruck darstellt.Compiles the specified XPath expression, with the IXmlNamespaceResolver object specified for namespace resolution, and returns an XPathExpression object that represents the XPath expression.

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
SetContext(IXmlNamespaceResolver)

Gibt beim Überschreiben in einer abgeleiteten Klasse das zum Auflösen von Namespaces zu verwendende IXmlNamespaceResolver-Objekt an.When overridden in a derived class, specifies the IXmlNamespaceResolver object to use for namespace resolution.

SetContext(XmlNamespaceManager)

Gibt beim Überschreiben in einer abgeleiteten Klasse das zum Auflösen von Namespaces zu verwendende XmlNamespaceManager-Objekt an.When overridden in a derived class, specifies the XmlNamespaceManager object to use for namespace resolution.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für: