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

Ссылка

Определение

Пространство имен:: Microsoft.Office.Tools.Word

Сборка:: Microsoft.Office.Tools.Word.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

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

abstract member SelectSingleNode : string * string * bool -> Microsoft.Office.Interop.Word.XMLNode

Public Function SelectSingleNode (XPath As String, Optional PrefixMapping As String = "", Optional FastSearchSkippingTextNodes As Boolean = true) As XMLNode

Параметры

XPath: String

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

PrefixMapping: String

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

FastSearchSkippingTextNodes: Boolean

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

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

XMLNode

Первый дочерний узел, соответствующий параметру XPath в элементе управления XMLNode.

Примеры

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

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

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

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

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

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

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

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