XMLNode.SelectSingleNode - метод

Статья
08/11/2011

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

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

Синтаксис

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

XMLNode SelectSingleNode(
    string XPath,
    string PrefixMapping,
    bool FastSearchSkippingTextNodes
)

Параметры

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

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

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

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

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

Заметки

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

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

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

Примеры

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

Private Sub FindLastNameNode()
    Dim element As String = "/x:Customer/x:LastName"
    Dim prefix As String = "xmlns:x='" & _
        Me.CustomerLastNameNode.NamespaceURI & "'"

    Dim node As Word.XMLNode = _
        Me.CustomerNode.SelectSingleNode(element, prefix, True)
    If node IsNot Nothing Then
        MsgBox(node.BaseName & " element was found.")
    Else
        MsgBox("The requested node was not found.")
    End If
End Sub

private void FindLastNameNode()
{
    string element = "/x:Customer/x:LastName";
    string prefix = "xmlns:x='" + 
        this.CustomerLastNameNode.NamespaceURI + "'";

    Word.XMLNode node = this.CustomerNode.SelectSingleNode(element,
        prefix, true);
    if (node != null)
    {
        MessageBox.Show(node.BaseName + " element was found.");
    }
    else
    {
        MessageBox.Show("The requested node was not found.");
    }
}

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

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

См. также

Ссылки

XMLNode Интерфейс

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

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