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