XMLNode.SelectNodes - метод

Статья
05/19/2013

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

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word (в Microsoft.Office.Tools.Word.dll)

Синтаксис

'Декларация
Function SelectNodes ( _
    XPath As String, _
    PrefixMapping As String, _
    FastSearchSkippingTextNodes As Boolean _
) As XMLNodes

XMLNodes SelectNodes(
    string XPath,
    string PrefixMapping,
    bool FastSearchSkippingTextNodes
)

Параметры

XPath
Тип: System.String
Допустимая строка в формате XPath.

PrefixMapping
Тип: System.String
Предоставляет префикс в схеме, по которой следует произвести поиск.Параметр PrefixMapping используется, если для поиска элементов в параметре XPath используются имена.

FastSearchSkippingTextNodes
Тип: System.Boolean
Значение true, чтобы при поиске указанного узла пропускать все текстовые узлы.Значение false, чтобы учитывать при поиске текстовые узлы.Значение по умолчанию — false.

Возвращаемое значение

Тип: Microsoft.Office.Interop.Word.XMLNodes
узлы, соответствующие параметру XPath, в порядке их появления в элементе управления Microsoft.Office.Tools.Word.XMLNode.

Заметки

Присвоение параметру FastSearchSkippingTextNodes значения false приводит к снижению производительности, поскольку приложение Microsoft Office Word выполняет поиск текста в узле по всем узлам документа.

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

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

Примеры

В приведенном ниже примере кода для получения коллекции дочерних узлов, соответствующих заданному параметру XPath, используется метод SelectNodes.Затем в примере выводится количество найденных узлов.В данном примере предполагается, что в текущем документе имеется объект XMLNode с именем CustomerNode, которому в схеме соответствует элемент с именем FirstName с одним или несколькими дочерними узлами.

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

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

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

XMLNode Интерфейс

Microsoft.Office.Tools.Word - пространство имен

Поделиться через