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

Определение

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

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

Параметры

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 слово выполняет поиск текста, содержащегося в узле, на всех узлах документа.

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

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

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