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

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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)

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: 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

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

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

SelectSingleNode(String)

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: 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

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

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

SelectSingleNode(XPathExpression)

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: 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

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

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

Teilen über

XPathNavigator.SelectSingleNode Methode

Definition

Überlädt

SelectSingleNode(String, IXmlNamespaceResolver)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

SelectSingleNode(String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

SelectSingleNode(XPathExpression)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

Zusätzliche Ressourcen