XPathExpression Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt eine typierte Klasse bereit, die einen kompilierten XPath-Ausdruck darstellt.
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.
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
Im Beispiel wird die contosoBooks.xml Datei als Eingabe verwendet.
<?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 XPathNavigator Klasse zurückgegeben. Es handelt sich um einen Parameter für die EvaluateKlassen , Matches, Selectund SelectSingleNode Methoden der XPathNavigator Klasse.
Hinweise für Ausführende
Wenn Sie von der XPathExpression Klasse erben, müssen Sie die folgenden Member überschreiben:
Eigenschaften
| Name | Beschreibung |
|---|---|
| Expression |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird eine |
| ReturnType |
Beim Überschreiben in einer abgeleiteten Klasse ruft der Ergebnistyp des XPath-Ausdrucks ab. |
Methoden
| Name | Beschreibung |
|---|---|
| AddSort(Object, IComparer) |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, werden die vom XPath-Ausdruck ausgewählten Knoten nach dem angegebenen IComparer Objekt sortiert. |
| AddSort(Object, XmlSortOrder, XmlCaseOrder, String, XmlDataType) |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, werden die vom XPath-Ausdruck ausgewählten Knoten gemäß den angegebenen Parametern sortiert. |
| Clone() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Klon dieser XPathExpressionKlasse zurückgegeben. |
| Compile(String, IXmlNamespaceResolver) |
Kompiliert den angegebenen XPath-Ausdruck mit dem für die IXmlNamespaceResolver Namespaceauflösung angegebenen Objekt und gibt ein XPathExpression Objekt zurück, das den XPath-Ausdruck darstellt. |
| Compile(String) |
Kompiliert den angegebenen XPath-Ausdruck und gibt ein XPathExpression Objekt zurück, das den XPath-Ausdruck darstellt. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| SetContext(IXmlNamespaceResolver) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird das objekt angegeben, das für die IXmlNamespaceResolver Namespaceauflösung verwendet werden soll. |
| SetContext(XmlNamespaceManager) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird das objekt angegeben, das für die XmlNamespaceManager Namespaceauflösung verwendet werden soll. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |