XPathNavigator.SelectSingleNode Метод

  • Ссылка

Определение

Пространство имен:
System.Xml.XPath
Сборка:
System.Xml.ReaderWriter.dll
Сборка:
System.Xml.XPath.dll
Сборка:
System.Xml.dll
Сборка:
netstandard.dll

Выбирает один узел в XPathNavigator.

Перегрузки

SelectSingleNode(String, IXmlNamespaceResolver)

Выбирает один узел в объекте XPathNavigator, используя указанный запрос XPath совместно с указанным объектом IXmlNamespaceResolver для разрешения префиксов пространства имен.
SelectSingleNode(String)

Выбирает один узел в XPathNavigator, используя указанный запрос XPath.
SelectSingleNode(XPathExpression)

Выбирает один узел в XPathNavigator, используя указанный объект XPathExpression.

SelectSingleNode(String, IXmlNamespaceResolver)

Выбирает один узел в объекте XPathNavigator, используя указанный запрос XPath совместно с указанным объектом IXmlNamespaceResolver для разрешения префиксов пространства имен.

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

Параметры

xpath
String

Строка String, представляющая выражение XPath.

resolver
IXmlNamespaceResolver

Объект IXmlNamespaceResolver, используемый для разрешения префиксов пространства имен в запросе XPath.

Возвращаемое значение

XPathNavigator

Объект XPathNavigator, содержащий первый узел, соответствующий указанному запросу XPath, или значение null, если результаты запроса отсутствуют.

Исключения

ArgumentException

Произошла ошибка в запросе XPath, или тип возвращаемого значения выражения XPath не является узлом.

XPathException

Недопустимый запрос XPath.

Примеры

В следующем примере выбирается один узел из XPathNavigator объекта на основе указанного запроса XPath и используется XmlNamespaceManager объект, указанный для разрешения префиксов пространства имен в запросе 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)

В примере в качестве входных данных используется файл 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>

Комментарии

Метод SelectSingleNode выбирает первый узел, соответствующий указанному запросу XPath. Метод SelectSingleNode использует IXmlNamespaceResolver объект для разрешения префиксов пространства имен.

Примечание

В XPath все пространства имен должны быть префиксированы в запросе. Если XML-документ использует пространство имен по умолчанию, необходимо добавить в объект префикс IXmlNamespaceResolver пространства имен.

Применяется к

SelectSingleNode(String)

Выбирает один узел в XPathNavigator, используя указанный запрос XPath.

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

Параметры

xpath
String

Строка String, представляющая выражение XPath.

Возвращаемое значение

XPathNavigator

Объект XPathNavigator, содержащий первый узел, соответствующий указанному запросу XPath, или значение null, если результаты запроса отсутствуют.

Исключения

ArgumentException

Произошла ошибка в запросе XPath, или тип возвращаемого значения выражения XPath не является узлом.

XPathException

Недопустимый запрос XPath.

Примеры

В следующем примере выбирается один узел на XPathNavigator основе указанного запроса XPath.

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)

В примере в качестве входных данных используется файл 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>

Комментарии

Метод SelectSingleNode выбирает первый узел, соответствующий запросу XPath в объекте XPathNavigator .

Применяется к

SelectSingleNode(XPathExpression)

Выбирает один узел в XPathNavigator, используя указанный объект 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);
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

Параметры

expression
XPathExpression

Объект XPathExpression, содержащий скомпилированный запрос XPath.

Возвращаемое значение

XPathNavigator

Объект XPathNavigator, содержащий первый узел, соответствующий указанному запросу XPath, или значение null, если результаты запроса отсутствуют.

Исключения

ArgumentException

Произошла ошибка в запросе XPath, или тип возвращаемого значения выражения XPath не является узлом.

XPathException

Недопустимый запрос XPath.

Примеры

В следующем примере выбирается один узел на XPathNavigator основе запроса XPath, содержащегося в файле 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)

В примере в качестве входных данных используется файл 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>

Комментарии

Метод SelectSingleNode выбирает первый узел, соответствующий скомпилированному запросу XPath, содержавшемся в XPathExpression объекте XPathNavigator.

Применяется к