XPathNavigator.Matches 方法

定义

命名空间:

System.Xml.XPath

程序集:

System.Xml.ReaderWriter.dll

确定当前节点是否与指定的 System.Xml.XPath 表达式匹配。

重载

Matches(String)	确定当前节点是否与指定的 XPath 表达式匹配。
Matches(XPathExpression)	确定当前节点是否匹配指定的 XPathExpression。

Matches(String)

Source:

XPathNavigator.cs

确定当前节点是否与指定的 XPath 表达式匹配。

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

参数

xpath

String

XPath 表达式。

返回

Boolean

如果当前节点与指定的 XPath 表达式匹配，则为 true；否则，为 false。

例外

ArgumentException

无法计算 XPath 表达式。

XPathException

XPath 表达式无效。

示例

有关 方法的示例 Matches ，请参阅 XPathNavigator.Matches 方法。

注解

此方法不会影响 的状态 XPathNavigator。

Matches(XPathExpression)

Source:

XPathNavigator.cs

确定当前节点是否匹配指定的 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

参数

expr

XPathExpression

包含已编译的 XPath 表达式的 XPathExpression 对象。

返回

Boolean

如果当前节点匹配 XPathExpression，则为 true；否则为 false。

例外

ArgumentException

无法计算 XPath 表达式。

XPathException

XPath 表达式无效。

示例

以下示例显示所有小说的标题。

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

该示例使用 文件 books.xml作为输入。

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

注解

此方法对 的状态 XPathNavigator没有影响。 此方法与 XPathNavigator.Matches 方法相同，只不过指定了 XPathExpression 包含已编译 XPath 表达式的对象，而不是 XPath 表达式 String。