XPathNavigator.SelectSingleNode Metodo

Definizione

Spazio dei nomi:: System.Xml.XPath

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Seleziona un singolo nodo in XPathNavigator.

Overload

Nome	Descrizione
SelectSingleNode(String, IXmlNamespaceResolver)	Seleziona un singolo nodo nell'oggetto XPathNavigator usando la query XPath specificata con l'oggetto IXmlNamespaceResolver specificato per risolvere i prefissi dello spazio dei nomi.
SelectSingleNode(String)	Seleziona un singolo nodo in XPathNavigator utilizzando la query XPath specificata.
SelectSingleNode(XPathExpression)	Seleziona un singolo nodo in XPathNavigator utilizzando l'oggetto specificato XPathExpression .

SelectSingleNode(String, IXmlNamespaceResolver)

Seleziona un singolo nodo nell'oggetto XPathNavigator usando la query XPath specificata con l'oggetto IXmlNamespaceResolver specificato per risolvere i prefissi dello spazio dei nomi.

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);

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

Parametri

xpath: String

Oggetto String che rappresenta un'espressione XPath.

resolver: IXmlNamespaceResolver

Oggetto IXmlNamespaceResolver utilizzato per risolvere i prefissi dello spazio dei nomi nella query XPath.

Valori restituiti

XPathNavigator

Oggetto XPathNavigator contenente il primo nodo corrispondente per la query XPath specificata; in caso contrario null , se non sono presenti risultati della query.

Eccezioni

ArgumentException

Si è verificato un errore nella query XPath o il tipo restituito dell'espressione XPath non è un nodo.

XPathException

La query XPath non è valida.

Esempio

Nell'esempio seguente viene selezionato un singolo nodo dall'oggetto XPathNavigator in base alla query XPath specificata e viene utilizzato l'oggetto XmlNamespaceManager specificato per risolvere i prefissi dello spazio dei nomi nella query XPath.

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'esempio accetta il contosoBooks.xml file come input.

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

Commenti

Il SelectSingleNode metodo seleziona il primo nodo che corrisponde alla query XPath specificata. Il SelectSingleNode metodo usa l'oggetto IXmlNamespaceResolver per risolvere i prefissi dello spazio dei nomi.

Note

In XPath tutti gli spazi dei nomi devono essere preceduti da una query. Se un documento XML usa uno spazio dei nomi predefinito, è comunque necessario aggiungere un prefisso dello spazio dei nomi all'oggetto IXmlNamespaceResolver .

Si applica a

SelectSingleNode(String)

Seleziona un singolo nodo in XPathNavigator utilizzando la query XPath specificata.

public:
 virtual System::Xml::XPath::XPathNavigator ^ SelectSingleNode(System::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

Parametri

xpath: String

Oggetto String che rappresenta un'espressione XPath.

Valori restituiti

XPathNavigator

Oggetto XPathNavigator contenente il primo nodo corrispondente per la query XPath specificata; in caso contrario, null se non sono presenti risultati della query.

Eccezioni

ArgumentException

Si è verificato un errore nella query XPath o il tipo restituito dell'espressione XPath non è un nodo.

XPathException

La query XPath non è valida.

Esempio

Nell'esempio seguente viene selezionato un singolo nodo da XPathNavigator in base alla query XPath specificata.

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'esempio accetta il books.xml file come input.

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

Commenti

Il SelectSingleNode metodo seleziona il primo nodo che corrisponde alla query XPath nell'oggetto XPathNavigator .

Si applica a

SelectSingleNode(XPathExpression)

Seleziona un singolo nodo in XPathNavigator utilizzando l'oggetto specificato 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);

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

Parametri

expression: XPathExpression

Oggetto XPathExpression contenente la query XPath compilata.

Valori restituiti

XPathNavigator

Oggetto XPathNavigator contenente il primo nodo corrispondente per la query XPath specificata; in caso contrario null , se non sono presenti risultati della query.

Eccezioni

ArgumentException

Si è verificato un errore nella query XPath o il tipo restituito dell'espressione XPath non è un nodo.

XPathException

La query XPath non è valida.

Esempio

Nell'esempio seguente viene selezionato un singolo nodo da XPathNavigator in base alla query XPath contenuta in XPathExpression.

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'esempio accetta il books.xml file come input.

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

Commenti

Il SelectSingleNode metodo seleziona il primo nodo che corrisponde alla query XPath compilata contenuta nell'oggetto XPathExpression in XPathNavigator.

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?