Partager via

XPathNavigator.SelectSingleNode Méthode

  • Référence

Définition

Espace de noms:
System.Xml.XPath
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XPath.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Sélectionne un nœud unique dans XPathNavigator.

Surcharges

SelectSingleNode(String, IXmlNamespaceResolver)

Sélectionne un nœud dans l'objet XPathNavigator à l'aide de la requête XPath spécifiée avec l'objet IXmlNamespaceResolver spécifié pour trouver les préfixes d'espace de noms.
SelectSingleNode(String)

Sélectionne un nœud dans XPathNavigator à l'aide de la requête XPath spécifiée.
SelectSingleNode(XPathExpression)

Sélectionne un nœud dans XPathNavigator à l'aide de l'objet XPathExpression spécifiée.

SelectSingleNode(String, IXmlNamespaceResolver)

Sélectionne un nœud dans l'objet XPathNavigator à l'aide de la requête XPath spécifiée avec l'objet IXmlNamespaceResolver spécifié pour trouver les préfixes d'espace de noms.

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

Paramètres

xpath
String

Chaîne String représentant une expression XPath.

resolver
IXmlNamespaceResolver

Objet IXmlNamespaceResolver permettant de trouver les préfixes d'espace de noms dans la requête XPath.

Retours

XPathNavigator

Objet XPathNavigator qui contient le premier nœud correspondant pour la requête XPath spécifiée ; sinon, null s’il n’y a pas de résultats pour la requête.

Exceptions

ArgumentException

Une erreur a été trouvée dans la requête XPath ou le type de retour de l'expression XPath n'est pas un nœud.

XPathException

La requête XPath n’est pas valide.

Exemples

L’exemple suivant sélectionne un nœud unique à partir de l’objet XPathNavigator en fonction de la requête XPath spécifiée et utilise l’objet XmlNamespaceManager spécifié pour résoudre les préfixes d’espace de noms dans la requête 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)

L'exemple prend le fichier contosoBooks.xml comme entrée.

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

Remarques

La SelectSingleNode méthode sélectionne le premier nœud qui correspond à la requête XPath spécifiée. La SelectSingleNode méthode utilise l’objet pour résoudre les préfixes d’espace IXmlNamespaceResolver de noms.

Notes

Dans XPath, tous les espaces de noms doivent être préfixés dans une requête. Si un document XML utilise un espace de noms par défaut, vous devez toujours ajouter un préfixe d’espace de noms à l’objet IXmlNamespaceResolver .

S’applique à

SelectSingleNode(String)

Sélectionne un nœud dans XPathNavigator à l'aide de la requête XPath spécifiée.

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

Paramètres

xpath
String

String représentant une expression XPath.

Retours

XPathNavigator

Objet XPathNavigator qui contient le premier nœud correspondant pour la requête XPath spécifiée ; sinon, null s’il n’y a pas de résultats pour la requête.

Exceptions

ArgumentException

Une erreur a été trouvée dans la requête XPath ou le type de retour de l'expression XPath n'est pas un nœud.

XPathException

La requête XPath n’est pas valide.

Exemples

L’exemple suivant sélectionne un nœud unique à partir de la XPathNavigator requête XPath spécifiée.

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)

L'exemple prend le fichier books.xml comme entrée.

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

Remarques

La SelectSingleNode méthode sélectionne le premier nœud qui correspond à la requête XPath dans l’objet XPathNavigator .

S’applique à

SelectSingleNode(XPathExpression)

Sélectionne un nœud dans XPathNavigator à l'aide de l'objet XPathExpression spécifiée.

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

Paramètres

expression
XPathExpression

Objet XPathExpression contenant la requête XPath compilée.

Retours

XPathNavigator

Objet XPathNavigator qui contient le premier nœud correspondant pour la requête XPath spécifiée ; sinon, null s’il n’y a pas de résultats pour la requête.

Exceptions

ArgumentException

Une erreur a été trouvée dans la requête XPath ou le type de retour de l'expression XPath n'est pas un nœud.

XPathException

La requête XPath n’est pas valide.

Exemples

L’exemple suivant sélectionne un nœud unique à partir de la XPathNavigator requête XPath contenue dans le 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)

L'exemple prend le fichier books.xml comme entrée.

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

Remarques

La SelectSingleNode méthode sélectionne le premier nœud qui correspond à la requête XPath compilée contenue dans l’objet XPathExpression dans le XPathNavigator.

S’applique à