DocumentBase.SelectSingleNode(String, String, Boolean) Метод

Ссылка

Определение

Пространство имен:: Microsoft.Office.Tools.Word

Сборка:: Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Возвращает объект XMLNode, представляющий первый узел в документе, соответствующий параметру XPath.

public Microsoft.Office.Interop.Word.XMLNode SelectSingleNode (string xPath, string prefixMapping, bool fastSearchSkippingTextNodes);

member this.SelectSingleNode : string * string * bool -> Microsoft.Office.Interop.Word.XMLNode

Public Function SelectSingleNode (xPath As String, Optional prefixMapping As String, Optional fastSearchSkippingTextNodes As Boolean) As XMLNode

Параметры

xPath: String

Допустимая строка в формате XPath. Дополнительные сведения об XPath см. в справочнике по XPath.

prefixMapping: String

Предоставляет префикс в схеме, по которой следует произвести поиск. Используйте параметр , PrefixMapping если параметр XPath использует имена для поиска элементов.

fastSearchSkippingTextNodes: Boolean

Значение true используется для пропуска всех текстовых узлов при поиске указанного узла. Значение false включает при поиске текстовые узлы. Значение по умолчанию — false.

Возвращаемое значение

XMLNode

Объект XMLNode, представляющий первый узел, соответствующий параметру XPath в документе. Значение null, если не найдено ни одного узла, соответствующего параметру XPath.

Примеры

В следующем примере кода показано, как указать XPath параметры и PrefixMapping при вызове SelectSingleNode метода . Чтобы использовать этот пример, запустите его из ThisDocument класса в проекте уровня документа.

private void DocumentSelectSingleNode()
{
    if (this.XMLSchemaReferences.Count > 0)
    {
        string XPath = "/x:catalog/x:book/x:title";
        object key = 1;

        string PrefixMapping = "xmlns:x=\"" +
            this.XMLSchemaReferences.get_Item(ref key).NamespaceURI +
            "\"";

        Word.XMLNode node = this.SelectSingleNode(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

Private Sub DocumentSelectSingleNode()
    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.XMLNode = Me.SelectSingleNode(XPath, _
            PrefixMapping, True)
    Else
        MessageBox.Show("The document does not contain a " + _
            "schema reference.")
    End If
End Sub

FastSearchSkippingTextNodes Если задать для параметра значение true , производительность снижается, так как Microsoft Office Word выполняет поиск по всем узлам в документе по тексту, содержа рабочему узлу.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.

Применяется к

Поделиться через