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

정의

네임스페이스:

Microsoft.Office.Tools.Word

어셈블리:

Microsoft.Office.Tools.Word.v4.0.Utilities.dll

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

public Microsoft.Office.Interop.Word.XMLNode SelectSingleNode(string xPath, string prefixMapping, bool fastSearchSkippingTextNodes);

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

Public Function SelectSingleNode (xPath As String, Optional prefixMapping As String, Optional fastSearchSkippingTextNodes As Boolean) As XMLNode

매개 변수

xPath

String

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

prefixMapping

String

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

fastSearchSkippingTextNodes

Boolean

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

반환

XMLNode

문서의 XPath 매개 변수와 일치하는 첫 번째 노드를 나타내는 XMLNode 개체입니다. XPath 매개 변수와 일치하는 노드를 찾을 수 없으면 null입니다.

예제

다음 코드 예제를 지정 하는 방법에 설명 합니다 및 PrefixMapping 메서드를 XPath 호출할 SelectSingleNode 때 매개 변수입니다. 이 예제를 사용하려면 문서 수준 프로젝트의 클래스에서 ThisDocument 실행합니다.

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

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

설명

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

선택적 매개 변수

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