WorksheetBase.XmlMapQuery(String, Object, Object) Метод

Определение

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

public Microsoft.Office.Interop.Excel.Range XmlMapQuery (string xPath, object selectionNamespaces, object map);

Параметры

xPath
String

Запрашиваемый XPath.

selectionNamespaces
Object

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

map
Object

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

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

Range

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

Примеры

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

Этот пример предназначен для настройки на уровне документа.

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

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

    if (range1 == null)
    {
        MessageBox.Show("The specified XPath: '" + path +
            "' has not been mapped to the worksheet.");
    }
}
Private Sub WorksheetQueryXmlMap()
    Dim path As String = "/order/customer/address"
    Dim namespaces As String = "xmlns=http://www.contoso.com/orders"

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

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

Комментарии

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

В отличие от XmlDataQuery метода, XmlMapQuery метод возвращает весь столбец XML-списка, включая строку заголовка и строку вставки.

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

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

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