DocumentBase.SelectNodes(String, String, Boolean) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает коллекцию XMLNodes, в которой хранятся все узлы, соответствующие параметру XPath
в том порядке, в котором они представлены в документе.
public Microsoft.Office.Interop.Word.XMLNodes SelectNodes (string xPath, string prefixMapping, bool fastSearchSkippingTextNodes);
member this.SelectNodes : string * string * bool -> Microsoft.Office.Interop.Word.XMLNodes
Public Function SelectNodes (xPath As String, Optional prefixMapping As String, Optional fastSearchSkippingTextNodes As Boolean) As XMLNodes
Параметры
- xPath
- String
Допустимая строка в формате XPath. Дополнительные сведения об XPath см. в справочнике по XPath.
- prefixMapping
- String
Предоставляет префикс в схеме, по которой следует произвести поиск. Используйте параметр , PrefixMapping
если параметр XPath
использует имена для поиска элементов.
- fastSearchSkippingTextNodes
- Boolean
Значение true
используется для пропуска всех текстовых узлов при поиске указанного узла. Значение false
включает при поиске текстовые узлы. Значение по умолчанию — false.
Возвращаемое значение
Коллекция XMLNodes, представляющая все узлы, соответствующие параметру XPath
в том порядке, в котором они представлены в документе. Значение null
, если не найдено ни одного узла, соответствующего параметру XPath
.
Примеры
В следующем примере кода показано, как указать XPath
параметры и PrefixMapping
при вызове SelectNodes метода . Чтобы использовать этот пример, запустите его из ThisDocument
класса в проекте уровня документа.
private void DocumentSelectNodes()
{
if (this.XMLSchemaReferences.Count > 0)
{
string XPath = "/x:catalog/x:book/x:title";
object key = 1;
string PrefixMapping = "xmlns:x=\"" +
this.XMLSchemaReferences[key].NamespaceURI +
"\"";
Word.XMLNodes nodes = this.SelectNodes(XPath,
PrefixMapping, true);
}
else
{
MessageBox.Show("The document does not contain a " +
"schema reference.");
}
}
Private Sub DocumentSelectNodes()
If Me.XMLSchemaReferences.Count > 0 Then
Dim XPath As String = "/x:catalog/x:book/x:title"
Dim PrefixMapping As String = "xmlns:x=""" + _
Me.XMLSchemaReferences(1).NamespaceURI + """"
Dim node As Word.XMLNodes = Me.SelectNodes(XPath, _
PrefixMapping, True)
Else
MessageBox.Show("The document does not contain a " + _
"schema reference.")
End If
End Sub
Комментарии
FastSearchSkippingTextNodes
Если задать для параметра значение , производительность снижаетсяtrue
, так как Microsoft Office Word выполняет поиск по всем узлам в документе по тексту в узле.
Необязательные параметры
Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.