DocumentBase.SelectSingleNode - метод

Статья
08/11/2011

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

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

Синтаксис

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

public XMLNode SelectSingleNode(
    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.XMLNode
Объект Microsoft.Office.Interop.Word.XMLNode, представляющий первый узел, соответствующий параметру XPath в документе. Значение nullпустая ссылка (Nothing в Visual Basic), если не найдено ни одного узла, соответствующего параметру XPath.

Заметки

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

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

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

Примеры

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

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

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

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

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

См. также

Ссылки

DocumentBase Класс

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

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