WorksheetBase.XmlDataQuery - метод

Статья
08/11/2011

Возвращает объект Range, представляющий ячейки, сопоставленные с определенным XPath. Возвращает nullпустая ссылка (Nothing в Visual Basic), если указанный XPath не сопоставлен с рабочим листом, или если сопоставленный диапазон пуст.

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v4.0.Utilities (в Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Синтаксис

'Декларация
Public Function XmlDataQuery ( _
    xPath As String, _
    selectionNamespaces As Object, _
    map As Object _
) As Range

public Range XmlDataQuery(
    string xPath,
    Object selectionNamespaces,
    Object map
)

Параметры

xPath
Тип: System.String
Запрашиваемый XPath.

selectionNamespaces
Тип: System.Object
Строка, содержащая разделенные пробелами пространства имен, на которые ссылается параметр XPath.Если одно из пространств имен не может быть разрешено, возникает ошибка во время выполнения.

map
Тип: System.Object
Объект-расширитель XmlMap.Если необходимо запросить XPath в пределах определенной карты, необходимо указать карту XML.

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

Тип: Microsoft.Office.Interop.Excel.Range
Объект Range, представляющий ячейки, сопоставленные с определенным XPath. Значение nullпустая ссылка (Nothing в Visual Basic), если указанный XPath не сопоставлен с рабочим листом, или если сопоставленный диапазон пуст.

Заметки

XML-функции, за исключением функции сохранения файлов в формате электронных таблиц XML, доступны только в Microsoft Office Professional Edition 2003 и Microsoft Office Excel 2003.

Если XPath находится в столбце XML-списка, в возвращаемый объект Range не включается строка заголовка или строка «Вставка».

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

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

Примеры

В следующем примере кода метод XmlDataQuery используется для получения диапазона Range ячеек, сопоставленных с определенным XPath.

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

Private Sub WorksheetQueryXmlData()
    Dim path As String = "/order/customer/address"
    Dim namespaces As String = "xmlns=https://www.contoso.com/orders"

    Dim range1 As Excel.Range = _
        Me.XmlDataQuery(path, namespaces)

    If range1 Is Nothing Then
        MsgBox("The specified XPath: '" & path & _
            "' has not been mapped to the worksheet, or the mapped " & _
                "range is empty.")
    End If
End Sub

private void WorksheetQueryXmlData()
{
    string path = "/order/customer/address";
    string namespaces = "xmlns=https://www.contoso.com/orders";

    Excel.Range range1 = this.XmlDataQuery(path, namespaces, missing);

    if (range1 == null)
    {
        MessageBox.Show("The specified XPath: '" + path + 
            "' has not been mapped to the worksheet, or the mapped " +
            "range is empty.");
    }
}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

WorksheetBase Класс

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

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