XPathNavigator.SelectSingleNode 메서드

정의

XPathNavigator에서 단일 노드를 선택합니다.Selects a single node in the XPathNavigator.

오버로드

SelectSingleNode(String, IXmlNamespaceResolver)

네임스페이스 접두사를 확인하기 위해 지정된 IXmlNamespaceResolver 개체와 함께 지정된 XPath 쿼리를 사용하여 XPathNavigator 개체에서 단일 노드를 선택합니다.Selects a single node in the XPathNavigator object using the specified XPath query with the IXmlNamespaceResolver object specified to resolve namespace prefixes.

SelectSingleNode(String)

지정된 XPath 쿼리를 사용하여 XPathNavigator에서 단일 노드를 선택합니다.Selects a single node in the XPathNavigator using the specified XPath query.

SelectSingleNode(XPathExpression)

지정된 XPathExpression 개체를 사용하여 XPathNavigator에서 단일 노드를 선택합니다.Selects a single node in the XPathNavigator using the specified XPathExpression object.

SelectSingleNode(String, IXmlNamespaceResolver)

네임스페이스 접두사를 확인하기 위해 지정된 IXmlNamespaceResolver 개체와 함께 지정된 XPath 쿼리를 사용하여 XPathNavigator 개체에서 단일 노드를 선택합니다.Selects a single node in the XPathNavigator object using the specified XPath query with the IXmlNamespaceResolver object specified to resolve namespace prefixes.

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);
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

XPath 식을 나타내는 String입니다.A String representing an XPath expression.

resolver
IXmlNamespaceResolver

XPath 쿼리에 있는 네임스페이스 접두사를 확인하는 데 사용되는 IXmlNamespaceResolver 개체입니다.The IXmlNamespaceResolver object used to resolve namespace prefixes in the XPath query.

반환

지정된 XPath 쿼리와 일치하는 첫 번째 노드를 포함하는 XPathNavigator 개체이거나, 쿼리 결과가 없으면 null입니다.An XPathNavigator object that contains the first matching node for the XPath query specified; otherwise null if there are no query results.

예외

XPath 쿼리에서 오류가 발생했거나 XPath 식의 반환 형식이 노드가 아닙니다.An error was encountered in the XPath query or the return type of the XPath expression is not a node.

XPath 쿼리가 잘못되었습니다.The XPath query is not valid.

예제

다음 예제에서 단일 노드를 선택 합니다 XPathNavigator 개체에서 지정 된 XPath 쿼리를 기반으로 사용 하는 XmlNamespaceManager XPath 쿼리에 있는 네임 스페이스 접두사를 확인 하기 위해 지정 된.The following example selects a single node from the XPathNavigator object based on the XPath query specified and uses the XmlNamespaceManager object specified to resolve namespace prefixes in the XPath query.

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 파일을 입력으로 사용합니다.The example takes the contosoBooks.xml file as an 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>  
  

설명

SelectSingleNode 메서드는 지정 된 XPath 쿼리와 일치 하는 첫 번째 노드를 선택 합니다.The SelectSingleNode method selects the first node that matches the XPath query specified. 합니다 SelectSingleNode 메서드는 IXmlNamespaceResolver 네임 스페이스 접두사를 확인 하는 개체입니다.The SelectSingleNode method uses the IXmlNamespaceResolver object to resolve namespace prefixes.

참고

Xpath에서 쿼리에서 모든 네임 스페이스 붙여야 합니다.In XPath all namespaces must be prefixed in a query. 기본 네임 스페이스를 사용 하는 XML 문서를 하는 경우 여전히 네임 스페이스 접두사를를 추가 해야 합니다는 IXmlNamespaceResolver 개체입니다.If an XML document uses a default namespace, you must still add a namespace prefix to the IXmlNamespaceResolver object.

SelectSingleNode(String)

지정된 XPath 쿼리를 사용하여 XPathNavigator에서 단일 노드를 선택합니다.Selects a single node in the XPathNavigator using the specified XPath query.

public:
 virtual System::Xml::XPath::XPathNavigator ^ SelectSingleNode(System::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

XPath 식을 나타내는 String입니다.A String representing an XPath expression.

반환

지정된 XPath 쿼리와 일치하는 첫 번째 노드를 포함하는 XPathNavigator 개체이거나, 쿼리 결과가 없으면 null입니다.An XPathNavigator object that contains the first matching node for the XPath query specified; otherwise, null if there are no query results.

예외

XPath 쿼리에서 오류가 발생했거나 XPath 식의 반환 형식이 노드가 아닙니다.An error was encountered in the XPath query or the return type of the XPath expression is not a node.

XPath 쿼리가 잘못되었습니다.The XPath query is not valid.

예제

다음 예제에서 단일 노드를 선택 합니다 XPathNavigator 지정 된 XPath 쿼리를 기반으로 합니다.The following example selects a single node from the XPathNavigator based on the XPath query specified.

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 파일을 입력으로 사용합니다.The example takes the books.xml file as an 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>  
  

설명

SelectSingleNode XPath 쿼리에서 일치 하는 첫 번째 노드를 선택 하는 메서드는 XPathNavigator 개체입니다.The SelectSingleNode method selects the first node that matches the XPath query in the XPathNavigator object.

SelectSingleNode(XPathExpression)

지정된 XPathExpression 개체를 사용하여 XPathNavigator에서 단일 노드를 선택합니다.Selects a single node in the XPathNavigator using the specified XPathExpression object.

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

컴파일된 XPath 쿼리를 포함하는 XPathExpression 개체입니다.An XPathExpression object containing the compiled XPath query.

반환

지정된 XPath 쿼리와 일치하는 첫 번째 노드를 포함하는 XPathNavigator 개체이거나, 쿼리 결과가 없으면 null입니다.An XPathNavigator object that contains the first matching node for the XPath query specified; otherwise null if there are no query results.

예외

XPath 쿼리에서 오류가 발생했거나 XPath 식의 반환 형식이 노드가 아닙니다.An error was encountered in the XPath query or the return type of the XPath expression is not a node.

XPath 쿼리가 잘못되었습니다.The XPath query is not valid.

예제

다음 예제에서 단일 노드를 선택 합니다 XPathNavigator 에 포함 된 XPath 쿼리를 기반으로 XPathExpression합니다.The following example selects a single node from the XPathNavigator based on the XPath query contained in the 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 파일을 입력으로 사용합니다.The example takes the books.xml file as an 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>  
  

설명

합니다 SelectSingleNode 에 포함 된 컴파일된 XPath 쿼리를 일치 하는 첫 번째 노드를 선택 하는 메서드를 XPathExpression 개체는 XPathNavigator합니다.The SelectSingleNode method selects the first node that matches the compiled XPath query contained in the XPathExpression object in the XPathNavigator.

적용 대상