XPathNavigator.SelectSingleNode Metoda

Reference

Definice

Obor názvů:: System.Xml.XPath

Sestavení:: System.Xml.ReaderWriter.dll

Sestavení:: System.Xml.XPath.dll

Sestavení:: System.Xml.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vybere jeden uzel v uzlu XPathNavigator.

Přetížení

SelectSingleNode(String, IXmlNamespaceResolver)	Vybere jeden uzel v objektu XPathNavigator pomocí zadaného dotazu XPath s objektem IXmlNamespaceResolver určeným k překladu předpon oboru názvů.
SelectSingleNode(String)	Vybere jeden uzel v zadaném XPathNavigator dotazu XPath.
SelectSingleNode(XPathExpression)	Vybere jeden uzel v zadaném objektu XPathNavigator XPathExpression .

SelectSingleNode(String, IXmlNamespaceResolver)

Vybere jeden uzel v objektu XPathNavigator pomocí zadaného dotazu XPath s objektem IXmlNamespaceResolver určeným k překladu předpon oboru názvů.

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

Parametry

xpath: String

A String představující výraz XPath.

resolver: IXmlNamespaceResolver

Objekt IXmlNamespaceResolver použitý k překladu předpon oboru názvů v dotazu XPath.

Návraty

XPathNavigator

Objekt XPathNavigator , který obsahuje první odpovídající uzel pro zadaný dotaz XPath, jinak null pokud neexistují žádné výsledky dotazu.

Výjimky

ArgumentException

V dotazu XPath došlo k chybě nebo návratový typ výrazu XPath není uzel.

XPathException

Dotaz XPath není platný.

Příklady

Následující příklad vybere jeden uzel z objektu XPathNavigator na základě zadaného dotazu XPath a použije XmlNamespaceManager objekt zadaný k překladu předpon oboru názvů v dotazu 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)

Příklad přebírá contosoBooks.xml soubor jako vstup.

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

Poznámky

Metoda SelectSingleNode vybere první uzel, který odpovídá zadanému dotazu XPath. Metoda SelectSingleNode používá IXmlNamespaceResolver objekt k překladu předpon oboru názvů.

Poznámka

V XPathu musí být všechny obory názvů předpony v dotazu. Pokud dokument XML používá výchozí obor názvů, musíte k objektu přidat předponu IXmlNamespaceResolver oboru názvů.

Platí pro

SelectSingleNode(String)

Vybere jeden uzel v zadaném XPathNavigator dotazu XPath.

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

Parametry

xpath: String

A String představující výraz XPath.

Návraty

XPathNavigator

Objekt XPathNavigator , který obsahuje první odpovídající uzel pro zadaný dotaz XPath, jinak pokud null neexistují žádné výsledky dotazu.

Výjimky

ArgumentException

V dotazu XPath došlo k chybě nebo návratový typ výrazu XPath není uzel.

XPathException

Dotaz XPath není platný.

Příklady

Následující příklad vybere jeden uzel ze zadaného XPathNavigator dotazu XPath.

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)

Příklad přebírá books.xml soubor jako vstup.

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

Poznámky

Metoda SelectSingleNode vybere první uzel, který odpovídá dotazu XPath v objektu XPathNavigator .

Platí pro

SelectSingleNode(XPathExpression)

Vybere jeden uzel v zadaném objektu XPathNavigator XPathExpression .

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

Parametry

expression: XPathExpression

Objekt XPathExpression obsahující zkompilovaný dotaz XPath.

Návraty

XPathNavigator

Objekt XPathNavigator , který obsahuje první odpovídající uzel pro zadaný dotaz XPath, jinak null pokud neexistují žádné výsledky dotazu.

Výjimky

ArgumentException

V dotazu XPath došlo k chybě nebo návratový typ výrazu XPath není uzel.

XPathException

Dotaz XPath není platný.

Příklady

Následující příklad vybere jeden uzel z XPathNavigator závislosti na dotazu XPath obsaženém XPathExpressionv .

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)

Příklad přebírá books.xml soubor jako vstup.

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

Poznámky

Metoda SelectSingleNode vybere první uzel, který odpovídá zkompilovanému dotazu XPath obsaženému v objektu XPathExpression v objektu XPathNavigator.

Platí pro

Sdílet prostřednictvím

XPathNavigator.SelectSingleNode Metoda

Definice

Přetížení

SelectSingleNode(String, IXmlNamespaceResolver)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Platí pro

SelectSingleNode(String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Platí pro

SelectSingleNode(XPathExpression)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Platí pro

Další materiály