XPathNavigator.SelectSingleNode Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Xml.XPath
Bütünleştirilmiş Kod:
System.Xml.ReaderWriter.dll
Bütünleştirilmiş Kod:
System.Xml.XPath.dll
Bütünleştirilmiş Kod:
System.Xml.dll
Bütünleştirilmiş Kod:
netstandard.dll

içinde XPathNavigatortek bir düğüm seçer.

Aşırı Yüklemeler

SelectSingleNode(String, IXmlNamespaceResolver)

Ad alanı ön eklerini çözümlemek XPathNavigator için belirtilen nesneyle belirtilen XPath sorgusunu kullanarak nesnede IXmlNamespaceResolver tek bir düğüm seçer.
SelectSingleNode(String)

Belirtilen XPath sorgusunu kullanarak içinde XPathNavigator tek bir düğüm seçer.
SelectSingleNode(XPathExpression)

belirtilen XPathExpression nesneyi kullanarak içinde XPathNavigator tek bir düğüm seçer.

SelectSingleNode(String, IXmlNamespaceResolver)

Kaynak:
XPathNavigator.cs
Kaynak:
XPathNavigator.cs
Kaynak:
XPathNavigator.cs

Ad alanı ön eklerini çözümlemek XPathNavigator için belirtilen nesneyle belirtilen XPath sorgusunu kullanarak nesnede IXmlNamespaceResolver tek bir düğüm seçer.

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

Parametreler

xpath
String

String XPath ifadesini temsil eden.

resolver
IXmlNamespaceResolver

IXmlNamespaceResolver XPath sorgusundaki ad alanı ön eklerini çözümlemek için kullanılan nesne.

Döndürülenler

XPathNavigator

XPathNavigator Belirtilen XPath sorgusu için ilk eşleşen düğümü içeren nesne; aksi takdirde null sorgu sonuçları yoksa.

Özel durumlar

ArgumentException

XPath sorgusunda bir hatayla karşılaşıldı veya XPath ifadesinin dönüş türü düğüm değil.

XPathException

XPath sorgusu geçerli değil.

Örnekler

Aşağıdaki örnek, belirtilen XPath sorgusuna göre nesneden XPathNavigator tek bir düğüm seçer ve XPath sorgusundaki XmlNamespaceManager ad alanı ön eklerini çözümlemek için belirtilen nesneyi kullanır.

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)

Örnek, dosyayı giriş olarak alır contosoBooks.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>

Açıklamalar

yöntemi, SelectSingleNode belirtilen XPath sorgusuyla eşleşen ilk düğümü seçer. yöntemi, SelectSingleNode ad alanı ön eklerini çözümlemek için nesnesini kullanır IXmlNamespaceResolver .

Not

XPath'te tüm ad alanları bir sorguya ön eklenmelidir. XML belgesi varsayılan ad alanı kullanıyorsa, nesneye IXmlNamespaceResolver yine de bir ad alanı ön eki eklemeniz gerekir.

Şunlara uygulanır

SelectSingleNode(String)

Kaynak:
XPathNavigator.cs
Kaynak:
XPathNavigator.cs
Kaynak:
XPathNavigator.cs

Belirtilen XPath sorgusunu kullanarak içinde XPathNavigator tek bir düğüm seçer.

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

Parametreler

xpath
String

String XPath ifadesini temsil eden.

Döndürülenler

XPathNavigator

XPathNavigator Belirtilen XPath sorgusu için ilk eşleşen düğümü içeren nesne; aksi takdirde sorgu null sonucu yoksa.

Özel durumlar

ArgumentException

XPath sorgusunda bir hatayla karşılaşıldı veya XPath ifadesinin dönüş türü düğüm değil.

XPathException

XPath sorgusu geçerli değil.

Örnekler

Aşağıdaki örnek, belirtilen XPath sorgusuna göre içinden XPathNavigator tek bir düğüm seçer.

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)

Örnek, dosyayı giriş olarak alır books.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>

Açıklamalar

yöntemi nesnesindeki SelectSingleNode XPath sorgusuyla XPathNavigator eşleşen ilk düğümü seçer.

Şunlara uygulanır

SelectSingleNode(XPathExpression)

Kaynak:
XPathNavigator.cs
Kaynak:
XPathNavigator.cs
Kaynak:
XPathNavigator.cs

belirtilen XPathExpression nesneyi kullanarak içinde XPathNavigator tek bir düğüm seçer.

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

Parametreler

expression
XPathExpression

XPathExpression Derlenmiş XPath sorgusunu içeren bir nesne.

Döndürülenler

XPathNavigator

XPathNavigator Belirtilen XPath sorgusu için ilk eşleşen düğümü içeren nesne; aksi takdirde null sorgu sonuçları yoksa.

Özel durumlar

ArgumentException

XPath sorgusunda bir hatayla karşılaşıldı veya XPath ifadesinin dönüş türü düğüm değil.

XPathException

XPath sorgusu geçerli değil.

Örnekler

Aşağıdaki örnek, içinde yer alan XPathExpressionXPath sorgusuna göre dosyasından tek bir düğüm XPathNavigator seçer.

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)

Örnek, dosyayı giriş olarak alır books.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>

Açıklamalar

yöntemi, SelectSingleNode içindeki nesnesinde XPathNavigatorbulunan derlenmiş XPath sorgusuyla XPathExpression eşleşen ilk düğümü seçer.

Şunlara uygulanır