XMLNode.SelectSingleNode(String, String, Boolean) 메서드

정의

네임스페이스:

Microsoft.Office.Tools.Word

어셈블리:

Microsoft.Office.Tools.Word.dll

XMLNode 컨트롤에서 XPath 매개 변수와 일치하는 첫 번째 자식 노드를 나타내는 XMLNode 개체를 가져옵니다.

public Microsoft.Office.Interop.Word.XMLNode SelectSingleNode (string XPath, string PrefixMapping = "", bool FastSearchSkippingTextNodes = true);

abstract member SelectSingleNode : string * string * bool -> Microsoft.Office.Interop.Word.XMLNode

Public Function SelectSingleNode (XPath As String, Optional PrefixMapping As String = "", Optional FastSearchSkippingTextNodes As Boolean = true) As XMLNode

매개 변수

XPath

String

유효한 XPath 문자열입니다.

PrefixMapping

String

검색을 수행할 스키마의 접두사를 제공합니다. 매개 변수가 PrefixMapping 이름을 사용하여 요소를 검색하는 경우 XPath 매개 변수를 사용합니다.

FastSearchSkippingTextNodes

Boolean

지정된 노드를 검색하는 동안 모든 텍스트 노드를 건너뛰려면 true이고, 검색에 텍스트 노드를 포함하려면 false입니다. 기본값은 true여야 합니다.

반환

XMLNode

XMLNode 컨트롤에서 XPath 매개 변수와 일치하는 첫 번째 자식 노드입니다.

예제

다음 코드 예제에서는 메서드를 SelectSingleNode 사용하여 지정된 XPath 매개 변수와 일치하는 자식 노드를 가져옵니다. 그런 다음, 이 예제에서는 찾은 노드의 이름을 표시합니다. 이 예제에서는 현재 문서에 라는 하나 이상의 자식 노드가 포함된 일치하는 스키마 요소가 있는 라는 CustomerNode 가 LastName포함되어 XMLNode 있다고 가정합니다.

private void FindLastNameNode()
{
    string element = "/x:Customer/x:LastName";
    string prefix = "xmlns:x='" + 
        this.CustomerLastNameNode.NamespaceURI + "'";

    Word.XMLNode node = this.CustomerNode.SelectSingleNode(element,
        prefix, true);
    if (node != null)
    {
        MessageBox.Show(node.BaseName + " element was found.");
    }
    else
    {
        MessageBox.Show("The requested node was not found.");
    }
}

Private Sub FindLastNameNode()
    Dim element As String = "/x:Customer/x:LastName"
    Dim prefix As String = "xmlns:x='" & _
        Me.CustomerLastNameNode.NamespaceURI & "'"

    Dim node As Word.XMLNode = _
        Me.CustomerNode.SelectSingleNode(element, prefix, True)
    If node IsNot Nothing Then
        MsgBox(node.BaseName & " element was found.")
    Else
        MsgBox("The requested node was not found.")
    End If
End Sub

설명

FastSearchSkippingTextNodes Microsoft Office Word 문서의 모든 노드에서 노드에 포함된 텍스트를 검색하므로 false 매개 변수를 로 설정하면 성능이 저하됩니다.

선택적 매개 변수

선택적 매개 변수에 대한 자세한 내용은 Office 솔루션의 선택적 매개 변수를 참조하세요.