DocumentBase.SelectSingleNode 메서드

아티클
08/10/2011

XPath 매개 변수와 일치하는 문서의 첫 번째 노드를 나타내는 Microsoft.Office.Interop.Word.XMLNode 개체를 반환합니다.

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

구문

‘선언
Public Function SelectSingleNode ( _
    xPath As String, _
    prefixMapping As String, _
    fastSearchSkippingTextNodes As Boolean _
) As XMLNode

public XMLNode SelectSingleNode(
    string xPath,
    string prefixMapping,
    bool fastSearchSkippingTextNodes
)

매개 변수

xPath
형식: System.String
유효한 XPath 문자열입니다.XPath에 대한 자세한 내용은 XPath 참조를 참조하십시오.

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

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

반환 값

형식: Microsoft.Office.Interop.Word.XMLNode
문서의 XPath 매개 변수와 일치하는 첫 번째 노드를 나타내는 Microsoft.Office.Interop.Word.XMLNode 개체입니다. XPath 매개 변수와 일치하는 노드를 찾을 수 없으면 nullNull 참조(Visual Basic의 경우 Nothing)입니다.

설명

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

선택적 매개 변수

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

예제

다음 코드 예제에서는 SelectSingleNode 메서드를 호출할 때 XPath 및 PrefixMapping 매개 변수를 지정하는 방법을 보여 줍니다. 이 예제를 사용하려면 문서 수준 프로젝트 ThisDocument 클래스에서 실행하십시오.

Private Sub DocumentSelectSingleNode()
    If Me.XMLSchemaReferences.Count > 0 Then
        Dim XPath As String = "/x:catalog/x:book/x:title"
        Dim PrefixMapping As String = "xmlns:x=""" + _
            Me.XMLSchemaReferences(1).NamespaceURI + """"
        Dim node As Word.XMLNode = Me.SelectSingleNode(XPath, _
            PrefixMapping, True)
    Else
        MessageBox.Show("The document does not contain a " + _
            "schema reference.")
    End If
End Sub

private void DocumentSelectSingleNode()
{
    if (this.XMLSchemaReferences.Count > 0)
    {
        string XPath = "/x:catalog/x:book/x:title";
        object key = 1;

        string PrefixMapping = "xmlns:x=\"" +
            this.XMLSchemaReferences.get_Item(ref key).NamespaceURI +
            "\"";

        Word.XMLNode node = this.SelectSingleNode(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

.NET Framework 보안

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

참고 항목

참조

DocumentBase 클래스

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

Share via