XPathNavigator.SelectSingleNode Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Xml.XPath
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XPath.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Seleziona un singolo nodo della classe XPathNavigator.

Overload

SelectSingleNode(String, IXmlNamespaceResolver)

Seleziona un singolo nodo nell'oggetto XPathNavigator utilizzando la query XPath specificata con l'oggetto IXmlNamespaceResolver specificato per la risoluzione dei prefissi degli spazi dei nomi.
SelectSingleNode(String)

Seleziona un singolo nodo della classe XPathNavigator utilizzando la query XPath specificata.
SelectSingleNode(XPathExpression)

Seleziona un singolo nodo della classe XPathNavigator utilizzando l'oggetto XPathExpression specificato.

SelectSingleNode(String, IXmlNamespaceResolver)

Origine:
XPathNavigator.cs
Origine:
XPathNavigator.cs
Origine:
XPathNavigator.cs

Seleziona un singolo nodo nell'oggetto XPathNavigator utilizzando la query XPath specificata con l'oggetto IXmlNamespaceResolver specificato per la risoluzione dei prefissi degli spazi 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);
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

String che rappresenta un'espressione XPath.

resolver
IXmlNamespaceResolver

Oggetto IXmlNamespaceResolver utilizzato per la risoluzione dei prefissi degli spazi dei nomi contenuti nella query XPath.

Restituisce

XPathNavigator

Oggetto XPathNavigator contenente il primo nodo corrispondente per la query XPath specificata; in caso contrario, null se non sono disponibili 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 = 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)

Nell'esempio il file contosoBooks.xml viene considerato 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 corrispondente alla query XPath specificata. Il SelectSingleNode metodo usa l'oggetto IXmlNamespaceResolver per risolvere i prefissi dello spazio dei nomi.

Nota

In XPath tutti gli spazi dei nomi devono essere preceduti da un prefisso in 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)

Origine:
XPathNavigator.cs
Origine:
XPathNavigator.cs
Origine:
XPathNavigator.cs

Seleziona un singolo nodo della classe 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);
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

String che rappresenta un'espressione XPath.

Restituisce

XPathNavigator

Oggetto XPathNavigator contenente il primo nodo corrispondente per la query XPath specificata; in caso contrario, null se non sono disponibili 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.

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)

Nell'esempio il file books.xml viene considerato 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 corrispondente alla query XPath nell'oggetto XPathNavigator .

Si applica a

SelectSingleNode(XPathExpression)

Origine:
XPathNavigator.cs
Origine:
XPathNavigator.cs
Origine:
XPathNavigator.cs

Seleziona un singolo nodo della classe XPathNavigator utilizzando l'oggetto XPathExpression specificato.

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

Parametri

expression
XPathExpression

Oggetto XPathExpression contenente la query XPath compilata.

Restituisce

XPathNavigator

Oggetto XPathNavigator contenente il primo nodo corrispondente per la query XPath specificata; in caso contrario, null se non sono disponibili 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 = 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)

Nell'esempio il file books.xml viene considerato 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