Zapytanie o obszary komórek mapowane na ścieżkę mapy XML przy użyciu Aspose.Cells

Wstęp

Czy kiedykolwiek zastanawiałeś się, jak pracować z danymi XML w programie Excel przy użyciu .NET? Dzięki Aspose.Cells for .NET, potężnej bibliotece do manipulacji arkuszami kalkulacyjnymi, możesz łatwo wchodzić w interakcje z mapami XML w plikach Excel. Wyobraź sobie, że masz plik Excel wypełniony ustrukturyzowanymi danymi i musisz wykonać zapytanie o określone obszary zamapowane na ścieżki XML — tutaj właśnie błyszczy Aspose.Cells. W tym samouczku zagłębimy się w zapytanie o obszary komórek zamapowane na ścieżki map XML w plikach Excel przy użyciu Aspose.Cells for .NET. Niezależnie od tego, czy chcesz tworzyć dynamiczne raporty, czy automatyzować ekstrakcję danych, ten przewodnik zawiera instrukcje krok po kroku.

Wymagania wstępne

Zanim przejdziemy do kodowania, jest kilka rzeczy, których będziesz potrzebować:

  1. Aspose.Cells dla .NET: Upewnij się, że masz zainstalowaną tę bibliotekę. Możesz ją pobraćTutaj lub pobierz przez NuGet.
  2. Plik Excela z mapą XML: Do tego samouczka potrzebny będzie plik Excela (.xlsx) zawierający mapę XML.
  3. Środowisko programistyczne: W tym przewodniku założono, że używasz programu Visual Studio, ale każdy edytor języka C# powinien działać bez problemu.
  4. Licencja Aspose: W razie potrzeby możesz użyć licencji tymczasowej, którą możesz uzyskaćTutaj.

Importuj pakiety

Aby rozpocząć, zaimportuj niezbędne przestrzenie nazw do pliku kodu:

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

Dzięki tym pakietom będziesz mieć dostęp do skoroszytu, będziesz mógł manipulować arkuszami i wykonywać zapytania dotyczące map XML w arkuszu kalkulacyjnym.

Krok 1: Załaduj plik Excel zawierający mapę XML

Najpierw musisz załadować plik Excel, który już zawiera mapowanie XML. Ten plik działa jako źródło danych.

// Zdefiniuj ścieżki katalogów dla źródła i wyjścia
string sourceDir = "Your Document Directory";
// Załaduj plik Excel
Workbook wb = new Workbook(sourceDir + "sampleXmlMapQuery.xlsx");

Tutaj,Workbook jest klasą reprezentującą cały plik Excela, który ładujesz używając ścieżki pliku. Zamień"Your Document Directory" z rzeczywistą ścieżką do katalogu, w którym znajduje się Twój plik.

Krok 2: Uzyskaj dostęp do mapy XML w skoroszycie

Po załadowaniu pliku następnym krokiem jest dostęp do mapy XML w skoroszycie. Mapa ta działa jako pomost między arkuszem kalkulacyjnym a danymi XML.

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

Tutaj pobieramy pierwszą mapę XML w skoroszycie, uzyskując dostęp doXmlMaps[0] zWorksheets kolekcja. W skoroszycie można mieć wiele map XML, a ten samouczek skupia się na pierwszej.

Krok 3: Uzyskaj dostęp do arkusza kalkulacyjnego w celu zapytania

Mając gotową mapę XML, teraz będziesz chciał wybrać konkretny arkusz roboczy, w którym znajdują się zmapowane dane. Zazwyczaj jest to pierwszy arkusz roboczy, ale zależy to od konfiguracji pliku.

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

Dostęp do arkusza kalkulacyjnego, w którym znajdują się dane mapowane na XML, umożliwia Ci dotarcie do określonych komórek. Tutaj używamy pierwszego arkusza kalkulacyjnego, ale możesz wybrać dowolny inny arkusz kalkulacyjny, zmieniając indeks lub określając nazwę.

Krok 4: Zapytanie mapy XML przy użyciu ścieżki

Teraz nadchodzi główna część: zapytanie do mapy XML. Tutaj określisz ścieżkę XML i pobierzesz dane zamapowane na tę ścieżkę w arkuszu kalkulacyjnym.

Console.WriteLine("Query Xml Map from Path - /MiscData");
ArrayList ret = ws.XmlMapQuery("/MiscData", xmap);

TenXmlMapQueryMetoda przyjmuje dwa parametry — ścieżkę XML i mapę XML pobraną wcześniej. W tym przykładzie przeszukujemy ścieżkę/MiscData , która jest ścieżką najwyższego poziomu w strukturze XML. Wyniki są przechowywane wArrayList, co ułatwia iterację.

Krok 5: Wyświetl wyniki zapytania

Po zapytaniu danych następnym krokiem jest wyświetlenie wyników. Wydrukujmy każdy element zArrayList do konsoli, aby uzyskać przejrzysty podgląd wyodrębnionych danych.

// Wydrukuj wyniki zapytania
for (int i = 0; i < ret.Count; i++)
{
    Console.WriteLine(ret[i]);
}

Ta pętla przechodzi przez każdy element wArrayList i drukuje je na konsoli. Zobaczysz dane wyodrębnione ze ścieżki mapy XML/MiscData.

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

Aby doprecyzować zapytanie, przeanalizujmy zagnieżdżoną ścieżkę w strukturze XML, taką jak/MiscData/row/Color.

Console.WriteLine("Query Xml Map from Path - /MiscData/row/Color");
ret = ws.XmlMapQuery("/MiscData/row/Color", xmap);

Tutaj przeszukujemy bardziej szczegółową ścieżkę w danych XML. Poprzez zawężenie do/MiscData/row/Color , kierujesz tylko informacje o kolorze podrow węzeł w strukturze XML.

Krok 7: Wyświetlanie wyników zapytania ścieżki zagnieżdżonej

Na koniec należy wydrukować wyniki tego udoskonalonego zapytania, aby zobaczyć konkretne wartości mapowane na/MiscData/row/Color.

// Wydrukuj wyniki zagnieżdżonego zapytania ścieżki
for (int i = 0; i < ret.Count; i++)
{
    Console.WriteLine(ret[i]);
}

Podobnie jak poprzednio, pętla ta wyprowadza wyniki zapytania do konsoli, umożliwiając przeglądanie konkretnych danych pobranych z zagnieżdżonej ścieżki XML.

Wniosek

I masz to! Dzięki Aspose.Cells dla .NET, wyszukiwanie obszarów komórek mapowanych na ścieżki map XML jest proste i wysoce skuteczne. Ta potężna funkcja zmienia zasady gry dla deweloperów, którzy muszą wyodrębnić określone dane XML z arkuszy kalkulacyjnych. Masz teraz podstawy do implementacji bardziej złożonych zapytań XML, a nawet łączenia wielu mapowań XML w ramach przepływów pracy programu Excel. Jesteś gotowy, aby pójść dalej? Zapoznaj się z dokumentacją Aspose.Cells, aby uzyskać dodatkowe funkcjonalności map XML, które ulepszą Twoje aplikacje!

Najczęściej zadawane pytania

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

Tak, Aspose.Cells pozwala na zarządzanie wieloma mapami XML w skoroszycie, umożliwiając złożone interakcje danych.

Co się stanie, jeśli ścieżka XML nie będzie istnieć na mapie?

Jeżeli ścieżka jest nieprawidłowa lub nie istnieje,XmlMapQuery metoda zwróci pustyArrayList.

Czy potrzebuję licencji, aby używać Aspose.Cells dla .NET?

Tak, licencja jest wymagana do pełnej funkcjonalności. Możesz wypróbowaćbezpłatny okres próbnylub zdobądźlicencja tymczasowa.

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

Oczywiście! Możesz wyodrębnić dane zapytania i zapisać je w innym pliku Excel lub dowolnym innym formacie obsługiwanym przez Aspose.Cells.

Czy możliwe jest zapytanie o mapy XML w formatach innych niż Excel (.xlsx)?

Mapowanie XML jest obsługiwane w plikach .xlsx. W przypadku innych formatów funkcjonalność może być ograniczona lub nieobsługiwana.

Pobierz ścieżkę XML z tabeli obiektów listy za pomocą Aspose.Cells