XMLNode.SelectSingleNode 메서드

아티클
08/10/2011

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

네임스페이스: Microsoft.Office.Tools.Word
어셈블리: Microsoft.Office.Tools.Word(Microsoft.Office.Tools.Word.dll)

구문

‘선언
Function SelectSingleNode ( _
    XPath As String, _
    PrefixMapping As String, _
    FastSearchSkippingTextNodes As Boolean _
) As XMLNode

XMLNode SelectSingleNode(
    string XPath,
    string PrefixMapping,
    bool FastSearchSkippingTextNodes
)

매개 변수

XPath
형식: System.String
유효한 XPath 문자열입니다.

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

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

반환 값

형식: Microsoft.Office.Interop.Word.XMLNode
Microsoft.Office.Tools.Word.XMLNode 컨트롤에서 XPath 매개 변수와 일치하는 첫 번째 자식 노드입니다.

설명

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

선택적 매개 변수

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

예제

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

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

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.");
    }
}

.NET Framework 보안

직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

XMLNode 인터페이스

Microsoft.Office.Tools.Word 네임스페이스

다음을 통해 공유