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, представляющий ячейки, сопоставленные с определенным 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.