XPathNavigator.Matches Metode

Definisi

Ruang nama:

System.Xml.XPath

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Menentukan apakah simpul saat ini cocok dengan ekspresi yang ditentukan System.Xml.XPath .

Overload

Nama	Deskripsi
Matches(String)	Menentukan apakah simpul saat ini cocok dengan ekspresi XPath yang ditentukan.
Matches(XPathExpression)	Menentukan apakah simpul saat ini cocok dengan yang ditentukan XPathExpression.

Matches(String)

Sumber:

XPathNavigator.cs

Menentukan apakah simpul saat ini cocok dengan ekspresi XPath yang ditentukan.

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

Parameter

xpath

String

Ekspresi XPath.

Mengembalikan

Boolean

true jika simpul saat ini cocok dengan ekspresi XPath yang ditentukan; jika tidak, false.

Pengecualian

ArgumentException

Ekspresi XPath tidak dapat dievaluasi.

XPathException

Ekspresi XPath tidak valid.

Contoh

Untuk contoh Matches metode , lihat XPathNavigator.Matches metode .

Keterangan

Metode ini tidak berpengaruh pada status XPathNavigator.

Matches(XPathExpression)

Sumber:

XPathNavigator.cs

Menentukan apakah simpul saat ini cocok dengan yang ditentukan 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

Parameter

expr

XPathExpression

Objek XPathExpression yang berisi ekspresi XPath yang dikompilasi.

Mengembalikan

Boolean

true jika simpul saat ini cocok dengan XPathExpression; jika tidak, false.

Pengecualian

ArgumentException

Ekspresi XPath tidak dapat dievaluasi.

XPathException

Ekspresi XPath tidak valid.

Contoh

Contoh berikut menampilkan judul semua novel.

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

Contohnya menggunakan file, books.xml, sebagai input.

<?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>

Keterangan

Metode ini tidak berpengaruh pada status XPathNavigator. Metode ini identik dengan XPathNavigator.Matches metode , kecuali bahwa objek yang XPathExpression berisi ekspresi XPath yang dikompilasi ditentukan, bukan ekspresi StringXPath .