XMLNode.SelectSingleNode(String, String, Boolean) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
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.