XPathNavigator.Matches Methode

Definitie

Naamruimte:
System.Xml.XPath
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Bepaalt of het huidige knooppunt overeenkomt met de opgegeven System.Xml.XPath expressie.

Overloads

Name Description
Matches(String)

Bepaalt of het huidige knooppunt overeenkomt met de opgegeven XPath-expressie.
Matches(XPathExpression)

Bepaalt of het huidige knooppunt overeenkomt met de opgegeven XPathExpression.

Matches(String)

Bepaalt of het huidige knooppunt overeenkomt met de opgegeven XPath-expressie.

public:
 virtual bool Matches(System::String ^ xpath);
public virtual bool Matches(string xpath);
abstract member Matches : string -> bool
override this.Matches : string -> bool
Public Overridable Function Matches (xpath As String) As Boolean

Parameters

xpath
String

De XPath-expressie.

Retouren

Boolean

true als het huidige knooppunt overeenkomt met de opgegeven XPath-expressie; anders, false.

Uitzonderingen

ArgumentException

De XPath-expressie kan niet worden geëvalueerd.

XPathException

De XPath-expressie is ongeldig.

Voorbeelden

Zie de methode voor een voorbeeld van de MatchesXPathNavigator.Matches methode.

Opmerkingen

Deze methode heeft geen invloed op de status van de XPathNavigator.

Van toepassing op

Matches(XPathExpression)

Bepaalt of het huidige knooppunt overeenkomt met de opgegeven XPathExpression.

public:
 virtual bool Matches(System::Xml::XPath::XPathExpression ^ expr);
public virtual bool Matches(System.Xml.XPath.XPathExpression expr);
abstract member Matches : System.Xml.XPath.XPathExpression -> bool
override this.Matches : System.Xml.XPath.XPathExpression -> bool
Public Overridable Function Matches (expr As XPathExpression) As Boolean

Parameters

expr
XPathExpression

Een XPathExpression object met de gecompileerde XPath-expressie.

Retouren

Boolean

trueals het huidige knooppunt overeenkomt met de XPathExpression; anders. false

Uitzonderingen

ArgumentException

De XPath-expressie kan niet worden geëvalueerd.

XPathException

De XPath-expressie is ongeldig.

Voorbeelden

In het volgende voorbeeld worden de titels van alle romans weergegeven.

XPathDocument document = new XPathDocument("books.xml");
XPathNavigator navigator = document.CreateNavigator();

// Select all book nodes.
XPathNodeIterator nodes = navigator.SelectDescendants("book", "", false);

// Select all book nodes that have the matching attribute value.
XPathExpression expr = navigator.Compile("book[@genre='novel']");
while (nodes.MoveNext())
{
    XPathNavigator navigator2 = nodes.Current.Clone();
    if (navigator2.Matches(expr))
    {
        navigator2.MoveToFirstChild();
        Console.WriteLine("Book title:  {0}", navigator2.Value);
    }
}

Dim document As XPathDocument = New XPathDocument("books.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

' Select all book nodes.
Dim nodes As XPathNodeIterator = navigator.SelectDescendants("book", "", False)

' Select all book nodes that have the matching attribute value.
Dim expr As XPathExpression = navigator.Compile("book[@genre='novel']")
While nodes.MoveNext()
    Dim navigator2 As XPathNavigator = nodes.Current.Clone()
    If navigator2.Matches(expr) Then
        navigator2.MoveToFirstChild()
        Console.WriteLine("Book title:  {0}", navigator2.Value)
    End If
End While

In het voorbeeld wordt het bestand als books.xmlinvoer gebruikt.

<?xml version="1.0" encoding="utf-8" ?>
<bookstore>
    <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>

Opmerkingen

Deze methode heeft geen effect op de status van de XPathNavigator. Deze methode is identiek aan de XPathNavigator.Matches methode, behalve dat een XPathExpression object met de gecompileerde XPath-expressie is opgegeven, in plaats van een XPath-expressie String.

Van toepassing op