DocumentBase.SelectNodes - метод

Статья
08/11/2011

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

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

Синтаксис

'Декларация
Public Function SelectNodes ( _
    xPath As String, _
    prefixMapping As String, _
    fastSearchSkippingTextNodes As Boolean _
) As XMLNodes

public XMLNodes SelectNodes(
    string xPath,
    string prefixMapping,
    bool fastSearchSkippingTextNodes
)

Параметры

xPath
Тип: System.String
Допустимая строка в формате XPath.Дополнительные сведения об XPath см. в справочнике по XPath.

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

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

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

Тип: Microsoft.Office.Interop.Word.XMLNodes
Коллекция Microsoft.Office.Interop.Word.XMLNodes, представляющая все узлы, соответствующие параметру XPath в том порядке, в котором они представлены в документе. Значение nullпустая ссылка (Nothing в Visual Basic), если не найдено ни одного узла, соответствующего параметру XPath.

Заметки

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

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

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

Примеры

В приведенном ниже примере кода демонстрируется, как задать параметры XPath и PrefixMapping при вызове метода SelectNodes. Чтобы использовать этот пример, запустите его из класса ThisDocument в проекте уровня документа.

Private Sub DocumentSelectNodes()
    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.XMLNodes = Me.SelectNodes(XPath, _
            PrefixMapping, True)
    Else
        MessageBox.Show("The document does not contain a " + _
            "schema reference.")
    End If
End Sub

private void DocumentSelectNodes()
{
    if (this.XMLSchemaReferences.Count > 0)
    {
        string XPath = "/x:catalog/x:book/x:title";
        object key = 1;
        string PrefixMapping = "xmlns:x=\"" +
            this.XMLSchemaReferences[key].NamespaceURI +
            "\"";
        Word.XMLNodes nodes = this.SelectNodes(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

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

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

См. также

Ссылки

DocumentBase Класс

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

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