XPathNavigator.SelectSingleNode Methode

  • Referenz

Definition

Namespace:
System.Xml.XPath
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XPath.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Wählt im XPathNavigator einen einzelnen Knoten aus.

Überlädt

SelectSingleNode(String, IXmlNamespaceResolver)

Wählt mit der angegebenen XPath-Abfrage einen einzelnen Knoten im XPathNavigator-Objekt aus. Dabei wird das angegebene IXmlNamespaceResolver-Objekt zum Auflösen von Namespacepräfixen verwendet.
SelectSingleNode(String)

Wählt im XPathNavigator mit der angegebenen XPath-Abfrage einen einzelnen Knoten aus.
SelectSingleNode(XPathExpression)

Wählt im XPathNavigator mit dem angegebenen XPathExpression-Objekt einen einzelnen Knoten aus.

SelectSingleNode(String, IXmlNamespaceResolver)

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

Wählt mit der angegebenen XPath-Abfrage einen einzelnen Knoten im XPathNavigator-Objekt aus. Dabei wird das angegebene IXmlNamespaceResolver-Objekt zum Auflösen von Namespacepräfixen verwendet.

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

Parameter

xpath
String

Ein String, der einen XPath-Ausdruck darstellt.

resolver
IXmlNamespaceResolver

Das IXmlNamespaceResolver-Objekt, das zum Auflösen von Namespacepräfixen in der XPath-Abfrage verwendet wird.

Gibt zurück

XPathNavigator

Ein XPathNavigator-Objekt, das den ersten übereinstimmenden Knoten für die angegebene XPath-Abfrage enthält. null, wenn keine Abfrageergebnisse vorhanden sind.

Ausnahmen

ArgumentException

In der XPath-Abfrage wurde ein Fehler gefunden, oder der Rückgabetyp des XPath-Ausdrucks ist kein Knoten.

XPathException

Die XPath-Abfrage ist ungültig.

Beispiele

Im folgenden Beispiel wird ein einzelner Knoten aus dem Objekt basierend auf der XPathNavigator angegebenen XPath-Abfrage ausgewählt und das XmlNamespaceManager angegebene Objekt verwendet, um Namespacepräfixe in der XPath-Abfrage aufzulösen.

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)

In diesem Beispiel wird die Datei contosoBooks.xml als Eingabe verwendet.

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

Hinweise

Die SelectSingleNode -Methode wählt den ersten Knoten aus, der der angegebenen XPath-Abfrage entspricht. Die SelectSingleNode -Methode verwendet das IXmlNamespaceResolver -Objekt, um Namespacepräfixe aufzulösen.

Hinweis

In XPath muss allen Namespaces in einer Abfrage das Präfix vorangestellt werden. Wenn ein XML-Dokument einen Standardnamespace verwendet, müssen Sie dem IXmlNamespaceResolver Objekt trotzdem ein Namespacepräfix hinzufügen.

Gilt für:

SelectSingleNode(String)

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

Wählt im XPathNavigator mit der angegebenen XPath-Abfrage einen einzelnen Knoten aus.

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

Parameter

xpath
String

Ein String, der einen XPath-Ausdruck darstellt.

Gibt zurück

XPathNavigator

Ein XPathNavigator-Objekt, das den ersten übereinstimmenden Knoten für die angegebene XPath-Abfrage enthält. null, wenn keine Abfrageergebnisse vorhanden sind.

Ausnahmen

ArgumentException

In der XPath-Abfrage wurde ein Fehler gefunden, oder der Rückgabetyp des XPath-Ausdrucks ist kein Knoten.

XPathException

Die XPath-Abfrage ist ungültig.

Beispiele

Im folgenden Beispiel wird basierend auf der angegebenen XPath-Abfrage ein einzelner Knoten aus dem XPathNavigator ausgewählt.

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)

In diesem Beispiel wird die Datei books.xml als Eingabe verwendet.

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

Hinweise

Die SelectSingleNode -Methode wählt den ersten Knoten aus, der der XPath-Abfrage im XPathNavigator -Objekt entspricht.

Gilt für:

SelectSingleNode(XPathExpression)

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

Wählt im XPathNavigator mit dem angegebenen XPathExpression-Objekt einen einzelnen Knoten aus.

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

Parameter

expression
XPathExpression

Ein XPathExpression-Objekt, das die kompilierte XPath-Abfrage enthält.

Gibt zurück

XPathNavigator

Ein XPathNavigator-Objekt, das den ersten übereinstimmenden Knoten für die angegebene XPath-Abfrage enthält. null, wenn keine Abfrageergebnisse vorhanden sind.

Ausnahmen

ArgumentException

In der XPath-Abfrage wurde ein Fehler gefunden, oder der Rückgabetyp des XPath-Ausdrucks ist kein Knoten.

XPathException

Die XPath-Abfrage ist ungültig.

Beispiele

Im folgenden Beispiel wird ein einzelner Knoten aus dem XPathNavigator basierend auf der XPath-Abfrage ausgewählt, die XPathExpressionim enthalten ist.

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)

In diesem Beispiel wird die Datei books.xml als Eingabe verwendet.

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

Hinweise

Die SelectSingleNode -Methode wählt den ersten Knoten aus, der der kompilierten XPath-Abfrage entspricht, die XPathExpression im -Objekt in der XPathNavigatorenthalten ist.

Gilt für: