XMLNode.SelectNodes(String, String, Boolean) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
public Microsoft.Office.Interop.Word.XMLNodes SelectNodes (string XPath, string PrefixMapping = "", bool FastSearchSkippingTextNodes = true);
Параметры
- XPath
- String
Допустимая строка в формате XPath.
- PrefixMapping
- String
Предоставляет префикс в схеме, по которой следует произвести поиск. Используйте параметр PrefixMapping, если ваш параметр XPath использует для поиска элементов имена.
- FastSearchSkippingTextNodes
- Boolean
Значение true, чтобы при поиске указанного узла пропускать все текстовые узлы. Значение false, чтобы учитывать при поиске текстовые узлы. Значение по умолчанию — false.
Возвращаемое значение
узлы, соответствующие параметру XPath, в порядке их появления в элементе управления XMLNode.
Примеры
В следующем примере кода метод используется SelectNodes для получения коллекции дочерних узлов, соответствующих заданному XPath параметру. Затем в примере отображается количество найденных узлов. В этом примере предполагается, что текущий документ содержит XMLNode именованный CustomerNode элемент с совпадающим элементом схемы, который содержит один или несколько дочерних узлов с именем FirstName .
private void DisplayFirstNameNodesCount()
{
string element = "/x:Customer/x:FirstName";
string prefix = "xmlns:x='" +
this.CustomerFirstNameNode.NamespaceURI + "'";
Word.XMLNodes nodes = this.CustomerNode.SelectNodes(element,
prefix, true);
MessageBox.Show(nodes.Count + " element(s) were found.");
}
Private Sub DisplayFirstNameNodesCount()
Dim element As String = "/x:Customer/x:FirstName"
Dim prefix As String = "xmlns:x='" & _
Me.CustomerFirstNameNode.NamespaceURI & "'"
Dim nodes As Word.XMLNodes = _
Me.CustomerNode.SelectNodes(element, prefix, True)
MsgBox(nodes.Count & " element(s) were found.")
End Sub
Комментарии
Установка FastSearchSkippingTextNodes параметра снижает false производительность, поскольку Microsoft Office слово выполняет поиск текста, содержащегося в узле, на всех узлах документа.
Необязательные параметры
Дополнительные сведения о необязательных параметрах см. в разделе необязательные параметры в решениях Office.