XMLNode.SelectNodes(String, String, Boolean) Метод

Определение

Возвращает коллекцию XMLNodes, в которой хранятся все узлы, соответствующие параметру XPath, в порядке их появления в элементе управления XMLNode.

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

Параметры

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 параметра снижает false производительность, поскольку Microsoft Office слово выполняет поиск текста, содержащегося в узле, на всех узлах документа.

Необязательные параметры

Дополнительные сведения о необязательных параметрах см. в разделе необязательные параметры в решениях Office.

Применяется к