XPathNavigator.Matches Methode
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.
Bestimmt, ob der aktuelle Knoten dem angegebenen System.Xml.XPath-Ausdruck entspricht.
| Matches(String) |
Bestimmt, ob der aktuelle Knoten dem angegebenen XPath-Ausdruck entspricht. |
| Matches(XPathExpression) |
Bestimmt, ob der aktuelle Knoten dem angegebenen XPathExpression entspricht. |
- Quelle:
- XPathNavigator.cs
- Quelle:
- XPathNavigator.cs
- Quelle:
- XPathNavigator.cs
Bestimmt, ob der aktuelle Knoten dem angegebenen XPath-Ausdruck entspricht.
public:
virtual bool Matches(System::String ^ xpath);public virtual bool Matches(string xpath);abstract member Matches : string -> bool
override this.Matches : string -> boolPublic Overridable Function Matches (xpath As String) As BooleanParameter
- xpath
- String
Der XPath-Ausdruck.
Gibt zurück
true, wenn der aktuelle Knoten dem angegebenen XPath-Ausdruck entspricht, andernfalls false.
Ausnahmen
Der XPath-Ausdruck kann nicht ausgewertet werden.
Der XPath-Ausdruck ist ungültig.
Beispiele
Ein Beispiel für die Matches -Methode finden Sie in der XPathNavigator.Matches -Methode.
Hinweise
Diese Methode hat keine Auswirkungen auf den Zustand von XPathNavigator.
Gilt für:
.NET 10 und andere Versionen
| Produkt | Versionen |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
- Quelle:
- XPathNavigator.cs
- Quelle:
- XPathNavigator.cs
- Quelle:
- XPathNavigator.cs
Bestimmt, ob der aktuelle Knoten dem angegebenen XPathExpression entspricht.
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 -> boolPublic Overridable Function Matches (expr As XPathExpression) As BooleanParameter
- expr
- XPathExpression
Ein XPathExpression-Objekt, das den kompilierten XPath-Ausdruck enthält.
Gibt zurück
true, wenn der aktuelle Knoten dem XPathExpression entspricht; andernfalls false.
Ausnahmen
Der XPath-Ausdruck kann nicht ausgewertet werden.
Der XPath-Ausdruck ist ungültig.
Beispiele
Im folgenden Beispiel werden die Titel aller Romane angezeigt.
XPathDocument^ document = gcnew 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);
}
}
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
Im Beispiel wird die Datei books.xmlals Eingabe verwendet.
<?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>
Hinweise
Diese Methode hat keine Auswirkungen auf den Zustand von XPathNavigator. Diese Methode ist mit der -Methode identisch, mit der XPathNavigator.Matches Ausnahme, dass anstelle eines XPath-Ausdrucks ein XPathExpression -Objekt angegeben wird, das den kompilierten XPath-Ausdruck Stringenthält.
Gilt für:
.NET 10 und andere Versionen
| Produkt | Versionen |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
Feedback zu .NET
.NET ist ein Open Source-Projekt. Wählen Sie einen Link aus, um Feedback zu geben: