Obszary komórek zapytania mapowane na ścieżkę mapy danych XML przy użyciu Aspose.Cells

Wstęp

Czy kiedykolwiek chciałeś wydajnie pracować z danymi XML w programie Excel przy użyciu .NET? Dzięki Aspose.Cells for .NET, potężnej bibliotece do manipulacji arkuszami kalkulacyjnymi, interakcja z mapami XML w plikach Excel staje się bezproblemowa. W tym samouczku zbadamy, jak wyszukiwać określone obszary zamapowane na ścieżki XML w plikach Excel, idealne do generowania dynamicznych raportów lub automatyzacji ekstrakcji danych. Zanurzmy się w procesie krok po kroku!

Wymagania wstępne

Zanim zaczniemy kodować, przygotuj następujące rzeczy:

  1. Aspose.Cells dla .NET: PobierzTutaj lub zainstaluj poprzez NuGet.
  2. Plik Excela z mapą XML: Będziesz potrzebować pliku Excela (.xlsx) zawierającego już mapę XML.
  3. Środowisko programistyczne: Ten przewodnik jest przeznaczony dla programu Visual Studio, ale inne edytory języka C# również będą działać.
  4. Licencja Aspose: Możesz uzyskać tymczasową licencjęTutaj jeśli potrzebujesz.

Konfigurowanie środowiska programistycznego

Zacznij od zaimportowania wymaganych przestrzeni nazw do pliku kodu:

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

Importując te pakiety, konfigurujesz swoje środowisko w celu uzyskania dostępu do skoroszytu i jego arkuszy oraz manipulowania nimi.

Krok 1: Załaduj plik Excel

Najpierw musisz załadować plik Excel zawierający mapowanie XML:

// Zdefiniuj katalog dla pliku źródłowego
string sourceDir = "Your Document Directory"; // Zaktualizuj ścieżkę odpowiednio

// Załaduj plik Excel
Workbook workbook = new Workbook(sourceDir + "sampleXmlMapQuery.xlsx");

Tutaj,Workbook reprezentuje cały plik Excela, który ładujesz używając ścieżki pliku.

Krok 2: Uzyskaj dostęp do mapy XML

Po załadowaniu pliku uzyskaj dostęp do mapy XML w skoroszycie:

// Uzyskaj dostęp do pierwszej mapy XML w skoroszycie
XmlMap xmlMap = workbook.Worksheets.XmlMaps[0];

Pobiera pierwszą mapę XML z skoroszytu. Jeśli skoroszyt zawiera wiele map, dostosuj indeks w razie potrzeby.

Krok 3: Wybierz arkusz roboczy

Następnie uzyskaj dostęp do arkusza kalkulacyjnego zawierającego zmapowane dane XML:

// Uzyskaj dostęp do pierwszego arkusza w skoroszycie
Worksheet worksheet = workbook.Worksheets[0];

W tym przypadku wybieramy pierwszy arkusz, ale w razie potrzeby możesz łatwo wybrać inny.

Krok 4: Zapytanie mapy XML

Teraz przeszukajmy mapę XML przy użyciu ścieżki XML. Na przykład, jeśli chcesz pobrać dane z/MiscData ścieżka, którą powinieneś wykonać:

// Zapytaj mapę XML, używając ścieżki
Console.WriteLine("Querying XML Map from Path - /MiscData");
ArrayList results = worksheet.XmlMapQuery("/MiscData", xmlMap);

Ta metoda przyjmuje ścieżkę XML i pobiera powiązane dane do obiektu ArrayList.

Krok 5: Wyświetlanie wyników zapytania

Teraz, gdy masz już wyszukane dane, wydrukuj wyniki na konsoli:

// Wyświetl wyniki zapytania
foreach (var result in results)
{
    Console.WriteLine(result);
}

Ta pętla umożliwia przeglądanie wszystkich elementów pobranych ze ścieżki XML.

Krok 6: Zapytanie o zagnieżdżoną ścieżkę XML

Możesz doprecyzować zapytanie, aby uzyskać bardziej szczegółowe dane. Na przykład, jeśli interesują Cię informacje o kolorze, które znajdziesz pod/MiscData/row/Color, należy dostosować zapytanie w następujący sposób:

// Zapytanie o zagnieżdżoną ścieżkę XML
Console.WriteLine("Querying XML Map from Path - /MiscData/row/Color");
results = worksheet.XmlMapQuery("/MiscData/row/Color", xmlMap);

Krok 7: Wyświetlanie zagnieżdżonych wyników zapytania

Na koniec wyświetlmy dane z tej konkretnej ścieżki:

// Wyświetl wyniki zagnieżdżonego zapytania o ścieżkę
foreach (var result in results)
{
    Console.WriteLine(result);
}

Ta pętla wydrukuje każdy element zagnieżdżonego zapytania, pokazując docelowe dane.

Wniosek

tym samouczku zbadaliśmy, jak wyszukiwać dane XML mapowane w plikach Excela przy użyciu Aspose.Cells dla .NET. Ta możliwość jest nieoceniona dla deweloperów, którzy chcą dynamicznie wyodrębniać określone dane XML. Dzięki tej podstawowej wiedzy możesz teraz wdrażać bardziej złożone zapytania XML, a nawet pracować z wieloma mapowaniami XML w swoich projektach Excela.

Najczęściej zadawane pytania

Czy mogę zmapować wiele plików XML w jednym skoroszycie programu Excel?

Tak, Aspose.Cells obsługuje zarządzanie wieloma mapami XML w ramach jednego skoroszytu.

A co jeśli ścieżka XML nie istnieje na mapie?

Jeśli zapytasz o nieprawidłową ścieżkę,XmlMapQuery Metoda zwróci pustą listę ArrayList.

Czy do korzystania z Aspose.Cells dla .NET wymagana jest licencja?

Tak, potrzebujesz licencji, aby uzyskać pełną funkcjonalność. Abezpłatny okres próbny ilicencja tymczasowa są dostępne.

Czy mogę zapisać dane zapytania w nowym pliku Excel?

Oczywiście! Możesz wyodrębnić dane i zapisać je w innym pliku Excel lub wyeksportować je do różnych formatów obsługiwanych przez Aspose.Cells.

Czy zapytania do map XML są obsługiwane w formatach innych niż Excel (.xlsx)?

Mapowanie XML jest obsługiwane przede wszystkim w plikach .xlsx, a funkcjonalności w przypadku innych formatów mogą być ograniczone.