Введение

Вы когда-нибудь хотели эффективно работать с XML-данными в Excel с помощью .NET? Благодаря Aspose.Cells для .NET, мощной библиотеке для работы с электронными таблицами, взаимодействие с XML-картами в файлах Excel становится простым и понятным. В этом руководстве мы рассмотрим, как выполнять запросы к определённым областям, сопоставленным с XML-путями в файлах Excel, что идеально подходит для создания динамических отчётов или автоматизации извлечения данных. Давайте разберёмся в этом пошаговом процессе!

Предпосылки

Прежде чем приступить к кодированию, обязательно подготовьте следующее:

  1. Aspose.Cells для .NET: загрузить здесь или установить через NuGet.
  2. Файл Excel с XML-картой: вам понадобится файл Excel (.xlsx) с уже существующей XML-картой.
  3. Среда разработки: это руководство адаптировано для Visual Studio, но подойдут и другие редакторы C#.
  4. Лицензия Aspose: вы можете получить временную лицензию здесь если он вам нужен.

Настройка среды разработки

Начните с импорта необходимых пространств имен в ваш файл кода:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Diagnostics;
using System.Collections;

Импортируя эти пакеты, вы настраиваете свою среду для доступа и управления рабочей книгой и ее рабочими листами.

Шаг 1: Загрузите файл Excel

Сначала вам необходимо загрузить файл Excel, содержащий XML-сопоставление:

// Определите каталог для исходного файла
string sourceDir = "Your Document Directory"; // Обновите путь соответствующим образом.

// Загрузите файл Excel
Workbook workbook = new Workbook(sourceDir + "sampleXmlMapQuery.xlsx");

Здесь, Workbook представляет собой весь ваш файл Excel, который вы загружаете, используя его путь к файлу.

Шаг 2: Доступ к XML-карте

После загрузки файла откройте карту XML в рабочей книге:

// Доступ к первой XML-карте в рабочей книге
XmlMap xmlMap = workbook.Worksheets.XmlMaps[0];

Это позволит получить первую XML-карту из вашей книги. Если ваша книга содержит несколько карт, при необходимости скорректируйте индекс.

Шаг 3: Выберите рабочий лист

Затем откройте рабочий лист, содержащий сопоставленные XML-данные:

// Доступ к первому листу в рабочей книге
Worksheet worksheet = workbook.Worksheets[0];

В этом случае мы выбираем первый рабочий лист, но при необходимости вы можете легко выбрать другой.

Шаг 4: Запрос XML-карты

Теперь давайте выполним запрос к XML-карте, используя XML-путь. Например, если вы хотите получить данные из /MiscData путь, вы бы сделали:

// Запросите карту XML, используя путь
Console.WriteLine("Querying XML Map from Path - /MiscData");
ArrayList results = worksheet.XmlMapQuery("/MiscData", xmlMap);

Этот метод принимает XML-путь и извлекает связанные данные в ArrayList.

Шаг 5: Отображение результатов запроса

Теперь, когда у вас есть запрошенные данные, давайте выведем результаты на консоль:

// Вывести результаты запроса
foreach (var result in results)
{
    Console.WriteLine(result);
}

Этот цикл позволяет просмотреть все элементы, извлеченные из XML-пути.

Шаг 6: Запрос вложенного XML-пути

Вы можете уточнить свой запрос, чтобы получить более точные данные. Например, если вас интересует информация о цвете, представленная в разделе /MiscData/row/Color, вы бы скорректировали свой запрос следующим образом:

// Запрос вложенного пути XML
Console.WriteLine("Querying XML Map from Path - /MiscData/row/Color");
results = worksheet.XmlMapQuery("/MiscData/row/Color", xmlMap);

Шаг 7: Отображение результатов вложенного запроса

Наконец, давайте отобразим данные по этому конкретному пути:

// Вывести результаты вложенного запроса пути
foreach (var result in results)
{
    Console.WriteLine(result);
}

Этот цикл выведет каждый элемент из вложенного запроса, показывая вам целевые данные.

Заключение

В этом руководстве мы рассмотрели, как запрашивать XML-данные, сопоставленные в файлах Excel, с помощью Aspose.Cells для .NET. Эта возможность бесценна для разработчиков, стремящихся динамически извлекать определённые XML-данные. Обладая этими базовыми знаниями, вы теперь сможете реализовывать более сложные XML-запросы и даже работать с несколькими сопоставлениями XML в своих проектах Excel.

Часто задаваемые вопросы

Можно ли сопоставить несколько XML-файлов в одной книге Excel?

Да, Aspose.Cells поддерживает управление несколькими XML-картами в пределах одной рабочей книги.

Что делать, если XML-путь отсутствует на карте?

Если вы запросите недействительный путь, XmlMapQuery метод вернет пустой ArrayList.

Требуется ли лицензия для использования Aspose.Cells для .NET?

Да, для полной функциональности вам нужна лицензия. бесплатная пробная версия и временная лицензия имеются в наличии.

Можно ли сохранить запрошенные данные в новый файл Excel?

Конечно! Вы можете извлечь данные и сохранить их в другом файле Excel или экспортировать в другие форматы, поддерживаемые Aspose.Cells.

Поддерживаются ли запросы к XML-картам в форматах, отличных от Excel (.xlsx)?

Сопоставление XML поддерживается в первую очередь в файлах .xlsx, а функциональность для других форматов может быть ограничена.