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

정의

네임스페이스:

Microsoft.Office.Tools.Word

어셈블리:

Microsoft.Office.Tools.Word.dll

XPath 매개 변수와 일치하는 모든 노드를 나타내는 XMLNodes 컬렉션을 XMLNode 컨트롤에 나타나는 순서대로 가져옵니다.

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

abstract member SelectNodes : string * string * bool -> Microsoft.Office.Interop.Word.XMLNodes

Public Function SelectNodes (XPath As String, Optional PrefixMapping As String = "", Optional FastSearchSkippingTextNodes As Boolean = true) As XMLNodes

매개 변수

XPath

String

유효한 XPath 문자열입니다.

PrefixMapping

String

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

FastSearchSkippingTextNodes

Boolean

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

반환

XMLNodes

XPath 매개 변수와 일치하는 노드로, XMLNode 컨트롤에 표시되는 순서대로 되어 있습니다.

예제

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

private void DisplayFirstNameNodesCount()
{
    string element = "/x:Customer/x:FirstName";
    string prefix = "xmlns:x='" + 
        this.CustomerFirstNameNode.NamespaceURI + "'";

    Word.XMLNodes nodes = this.CustomerNode.SelectNodes(element, 
        prefix, true);
    MessageBox.Show(nodes.Count + " element(s) were found.");
}

Private Sub DisplayFirstNameNodesCount()
    Dim element As String = "/x:Customer/x:FirstName"
    Dim prefix As String = "xmlns:x='" & _
        Me.CustomerFirstNameNode.NamespaceURI & "'"

    Dim nodes As Word.XMLNodes = _
        Me.CustomerNode.SelectNodes(element, prefix, True)
    MsgBox(nodes.Count & " element(s) were found.")
End Sub

설명

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

선택적 매개 변수

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