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

Document.SelectSingleNode Метод (2007 System)

  • Статья

Обновлен: Ноябрь 2007

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

Пространство имен:  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 Document
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. Дополнительные сведения о формате XPath см. в справочной документации по XPath на веб-узле MSDN.
  • PrefixMapping
    Тип: System.String
    Предоставляет префикс в схеме, по которой следует произвести поиск. Параметр PrefixMapping используется, если для поиска элементов в параметре XPath используются имена.
  • FastSearchSkippingTextNodes
    Тип: System.Boolean
    Значение true используется для пропуска всех текстовых узлов при поиске указанного узла. Значение false используется для включения текстовых узлов в область поиска. Значение по умолчанию — false.

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

Тип: Microsoft.Office.Interop.Word.XMLNode
Объект Microsoft.Office.Interop.Word.XMLNode, представляющий первый узел в документе, соответствующий параметру XPath в документе.

Заметки

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

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

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

Примеры

В приведенном ниже примере кода демонстрируется, как задать параметры XPath и PrefixMapping при вызове метода SelectSingleNode.

В этом примере демонстрируется настройка уровня документа.

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

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.");
    }
}

Разрешения

См. также

Ссылки

Document Класс

Document - члены

Microsoft.Office.Tools.Word - пространство имен