XPathNavigator.SelectSingleNode Método

  • Referencia

Definición

Espacio de nombres:
System.Xml.XPath
Ensamblado:
System.Xml.ReaderWriter.dll
Ensamblado:
System.Xml.XPath.dll
Ensamblado:
System.Xml.dll
Ensamblado:
netstandard.dll

Selecciona un solo nodo en el XPathNavigator.

Sobrecargas

SelectSingleNode(String, IXmlNamespaceResolver)

Selecciona un solo nodo del objeto XPathNavigator utilizando la consulta XPath especificada con el objeto IXmlNamespaceResolver especificado para resolver los prefijos de espacio de nombres.
SelectSingleNode(String)

Selecciona un solo nodo en el XPathNavigator mediante la consulta XPath especificada.
SelectSingleNode(XPathExpression)

Selecciona un solo nodo en el XPathNavigator mediante el objeto XPathExpression especificado.

SelectSingleNode(String, IXmlNamespaceResolver)

Source:
XPathNavigator.cs
Source:
XPathNavigator.cs
Source:
XPathNavigator.cs

Selecciona un solo nodo del objeto XPathNavigator utilizando la consulta XPath especificada con el objeto IXmlNamespaceResolver especificado para resolver los prefijos de espacio de nombres.

public:
 virtual System::Xml::XPath::XPathNavigator ^ SelectSingleNode(System::String ^ xpath, System::Xml::IXmlNamespaceResolver ^ resolver);
public virtual System.Xml.XPath.XPathNavigator? SelectSingleNode (string xpath, System.Xml.IXmlNamespaceResolver? resolver);
public virtual System.Xml.XPath.XPathNavigator SelectSingleNode (string xpath, System.Xml.IXmlNamespaceResolver resolver);
abstract member SelectSingleNode : string * System.Xml.IXmlNamespaceResolver -> System.Xml.XPath.XPathNavigator
override this.SelectSingleNode : string * System.Xml.IXmlNamespaceResolver -> System.Xml.XPath.XPathNavigator
Public Overridable Function SelectSingleNode (xpath As String, resolver As IXmlNamespaceResolver) As XPathNavigator

Parámetros

xpath
String

String que representa una expresión XPath.

resolver
IXmlNamespaceResolver

Objeto IXmlNamespaceResolver utilizado para resolver los prefijos de espacio de nombres en la consulta XPath.

Devoluciones

XPathNavigator

Objeto XPathNavigator que contiene el primer nodo que coincide con la consulta XPath especificada; en caso contrario, es null si la consulta no genera resultados.

Excepciones

ArgumentException

Se ha detectado un error en la consulta XPath o el tipo de valor devuelto de la expresión XPath no es un nodo.

XPathException

La consulta XPath no es válida.

Ejemplos

En el ejemplo siguiente se selecciona un único nodo del XPathNavigator objeto en función de la consulta XPath especificada y se usa el XmlNamespaceManager objeto especificado para resolver los prefijos de espacio de nombres en la consulta XPath.

XPathDocument^ document = gcnew XPathDocument("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();

XmlNamespaceManager^ manager = gcnew XmlNamespaceManager(navigator->NameTable);
manager->AddNamespace("bk", "http://www.contoso.com/books");

XPathNavigator^ node = navigator->SelectSingleNode("//bk:title", manager);
Console::WriteLine(node->InnerXml);

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

XmlNamespaceManager manager = new XmlNamespaceManager(navigator.NameTable);
manager.AddNamespace("bk", "http://www.contoso.com/books");

XPathNavigator node = navigator.SelectSingleNode("//bk:title", manager);
Console.WriteLine(node.InnerXml);

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

Dim manager As XmlNamespaceManager = New XmlNamespaceManager(navigator.NameTable)
manager.AddNamespace("bk", "http://www.contoso.com/books")

Dim node As XPathNavigator = navigator.SelectSingleNode("//bk:title", manager)
Console.WriteLine(node.InnerXml)

En el ejemplo se toma como entrada el archivo contosoBooks.xml.

<?xml version="1.0" encoding="utf-8" ?>  
<bookstore xmlns="http://www.contoso.com/books">  
    <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

El SelectSingleNode método selecciona el primer nodo que coincide con la consulta XPath especificada. El SelectSingleNode método usa el IXmlNamespaceResolver objeto para resolver prefijos de espacio de nombres.

Nota:

En XPath, todos los espacios de nombres deben tener el prefijo en una consulta. Si un documento XML usa un espacio de nombres predeterminado, debe agregar un prefijo de espacio de nombres al IXmlNamespaceResolver objeto .

Se aplica a

SelectSingleNode(String)

Source:
XPathNavigator.cs
Source:
XPathNavigator.cs
Source:
XPathNavigator.cs

Selecciona un solo nodo en el XPathNavigator mediante la consulta XPath especificada.

public:
 virtual System::Xml::XPath::XPathNavigator ^ SelectSingleNode(System::String ^ xpath);
public virtual System.Xml.XPath.XPathNavigator? SelectSingleNode (string xpath);
public virtual System.Xml.XPath.XPathNavigator SelectSingleNode (string xpath);
abstract member SelectSingleNode : string -> System.Xml.XPath.XPathNavigator
override this.SelectSingleNode : string -> System.Xml.XPath.XPathNavigator
Public Overridable Function SelectSingleNode (xpath As String) As XPathNavigator

Parámetros

xpath
String

String que representa una expresión XPath.

Devoluciones

XPathNavigator

Objeto XPathNavigator que contiene el primer nodo que coincide con la consulta XPath especificada; en caso contrario, es null si la consulta no genera resultados.

Excepciones

ArgumentException

Se ha detectado un error en la consulta XPath o el tipo de valor devuelto de la expresión XPath no es un nodo.

XPathException

La consulta XPath no es válida.

Ejemplos

En el ejemplo siguiente se selecciona un único nodo de según XPathNavigator la consulta XPath especificada.

XPathDocument^ document = gcnew XPathDocument("books.xml");
XPathNavigator^ navigator = document->CreateNavigator();

XPathNavigator^ node = navigator->SelectSingleNode("//title");
Console::WriteLine(node->InnerXml);

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

XPathNavigator node = navigator.SelectSingleNode("//title");
Console.WriteLine(node.InnerXml);

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

Dim node As XPathNavigator = navigator.SelectSingleNode("//title")
Console.WriteLine(node.InnerXml)

En el ejemplo se toma como entrada el archivo 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>

Comentarios

El SelectSingleNode método selecciona el primer nodo que coincide con la consulta XPath del XPathNavigator objeto .

Se aplica a

SelectSingleNode(XPathExpression)

Source:
XPathNavigator.cs
Source:
XPathNavigator.cs
Source:
XPathNavigator.cs

Selecciona un solo nodo en el XPathNavigator mediante el objeto XPathExpression especificado.

public:
 virtual System::Xml::XPath::XPathNavigator ^ SelectSingleNode(System::Xml::XPath::XPathExpression ^ expression);
public virtual System.Xml.XPath.XPathNavigator? SelectSingleNode (System.Xml.XPath.XPathExpression expression);
public virtual System.Xml.XPath.XPathNavigator SelectSingleNode (System.Xml.XPath.XPathExpression expression);
abstract member SelectSingleNode : System.Xml.XPath.XPathExpression -> System.Xml.XPath.XPathNavigator
override this.SelectSingleNode : System.Xml.XPath.XPathExpression -> System.Xml.XPath.XPathNavigator
Public Overridable Function SelectSingleNode (expression As XPathExpression) As XPathNavigator

Parámetros

expression
XPathExpression

Objeto XPathExpression que contiene la consulta XPath compilada.

Devoluciones

XPathNavigator

Objeto XPathNavigator que contiene el primer nodo que coincide con la consulta XPath especificada; en caso contrario, es null si la consulta no genera resultados.

Excepciones

ArgumentException

Se ha detectado un error en la consulta XPath o el tipo de valor devuelto de la expresión XPath no es un nodo.

XPathException

La consulta XPath no es válida.

Ejemplos

En el ejemplo siguiente se selecciona un único nodo de según XPathNavigator la consulta XPath contenida en .XPathExpression

XPathDocument^ document = gcnew XPathDocument("books.xml");
XPathNavigator^ navigator = document->CreateNavigator();

XPathExpression^ query = navigator->Compile("//title");

XPathNavigator^ node = navigator->SelectSingleNode(query);
Console::WriteLine(node->InnerXml);

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

XPathExpression query = navigator.Compile("//title");

XPathNavigator node = navigator.SelectSingleNode(query);
Console.WriteLine(node.InnerXml);

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

Dim query As XPathExpression = navigator.Compile("//title")

Dim node As XPathNavigator = navigator.SelectSingleNode(query)
Console.WriteLine(node.InnerXml)

En el ejemplo se toma como entrada el archivo 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>

Comentarios

El SelectSingleNode método selecciona el primer nodo que coincide con la consulta XPath compilada contenida en el XPathExpression objeto de XPathNavigator.

Se aplica a