XMLNode.SelectNodes Метод (2007 System)
Обновлен: Ноябрь 2007
Возвращает коллекцию Microsoft.Office.Interop.Word.XMLNodes, в которой хранятся все узлы, соответствующие параметру XPath, в порядке их появления в элементе управления Microsoft.Office.Tools.Word.XMLNode.
Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)
Синтаксис
'Декларация
Public Function SelectNodes ( _
XPath As String, _
PrefixMapping As String, _
FastSearchSkippingTextNodes As Boolean _
) As XMLNodes
'Применение
Dim instance As XMLNode
Dim XPath As String
Dim PrefixMapping As String
Dim FastSearchSkippingTextNodes As Boolean
Dim returnValue As XMLNodes
returnValue = instance.SelectNodes(XPath, _
PrefixMapping, FastSearchSkippingTextNodes)
public XMLNodes SelectNodes(
string XPath,
string PrefixMapping,
bool FastSearchSkippingTextNodes
)
Параметры
- XPath
Тип: System.String
Допустимая строка в формате XPath.
- PrefixMapping
Тип: System.String
Предоставляет префикс в схеме, в которой следует произвести поиск. Параметр PrefixMapping используется, если для поиска элементов в параметре XPath используются имена.
- FastSearchSkippingTextNodes
Тип: System.Boolean
Значение true используется для пропуска всех текстовых узлов при поиске указанного узла. Значение false используется для включения текстовых узлов в область поиска. Значение по умолчанию – false.
Возвращаемое значение
Тип: Microsoft.Office.Interop.Word.XMLNodes
Узлы, соответствующие параметру XPath, в порядке их появления в элементе управления Microsoft.Office.Tools.Word.XMLNode.
Заметки
Присвоение параметру FastSearchSkippingTextNodes значения false приводит к снижению производительности, поскольку приложение Microsoft Office Word выполняет поиск текста в узле по всем узлам документа.
Необязательные параметры
Сведения о необязательных параметрах см. в разделе Общие сведения о необязательных параметрах в решениях Office.
Примеры
В приведенном ниже примере кода для получения коллекции дочерних узлов, соответствующих заданному параметру XPath, используется метод SelectNodes. Затем в примере выводится количество найденных узлов. В данном примере предполагается, что в текущем документе имеется объект XMLNode с именем CustomerNode, которому в схеме соответствует элемент с именем FirstName с одним или несколькими дочерними узлами.
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
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.");
}
Разрешения
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.