XPathNavigator.Matches Método

Definición

Espacio de nombres:

System.Xml.XPath

Ensamblado:

System.Xml.ReaderWriter.dll

Determina si el nodo actual coincide con la expresión System.Xml.XPath especificada.

Sobrecargas

Matches(String)	Determina si el nodo actual coincide con la expresión XPath especificada.
Matches(XPathExpression)	Determina si el nodo actual coincide con la expresión XPathExpression especificada.

Matches(String)

Source:

XPathNavigator.cs

Determina si el nodo actual coincide con la expresión XPath especificada.

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

Parámetros

xpath

String

Expresión XPath.

Devoluciones

Boolean

true si el nodo actual coincide con la expresión XPath especificada; de lo contrario, es false.

Excepciones

ArgumentException

La expresión XPath no se puede evaluar.

XPathException

La expresión XPath no es válida.

Ejemplos

Para obtener un ejemplo del Matches método , vea el XPathNavigator.Matches método .

Comentarios

Este método no afecta al estado de XPathNavigator.

Matches(XPathExpression)

Source:

XPathNavigator.cs

Determina si el nodo actual coincide con la expresión XPathExpression especificada.

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

Parámetros

expr

XPathExpression

Objeto XPathExpression que contiene la expresión XPath compilada.

Devoluciones

Boolean

true si el nodo actual coincide con XPathExpression; en caso contrario, false.

Excepciones

ArgumentException

La expresión XPath no se puede evaluar.

XPathException

La expresión XPath no es válida.

Ejemplos

En el ejemplo siguiente se muestran los títulos de todas las novelas.

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

En el ejemplo se usa el archivo , books.xmlcomo entrada.

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

Comentarios

Este método no tiene ningún efecto en el estado de XPathNavigator. Este método es idéntico al XPathNavigator.Matches método , salvo que se especifica un XPathExpression objeto que contiene la expresión XPath compilada, en lugar de una expresión StringXPath .