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


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

Определение

Возвращает объект 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.

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

Первый дочерний узел, соответствующий параметру 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.

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