Perkenalan

Pernahkah Anda ingin bekerja secara efisien dengan data XML di Excel menggunakan .NET? Dengan Aspose.Cells untuk .NET, pustaka canggih untuk manipulasi spreadsheet, berinteraksi dengan peta XML dalam berkas Excel menjadi lebih mudah. Dalam tutorial ini, kita akan mempelajari cara mengkueri area tertentu yang dipetakan ke jalur XML dalam berkas Excel, ideal untuk menghasilkan laporan dinamis atau mengotomatiskan ekstraksi data. Mari kita selami prosesnya langkah demi langkah!

Prasyarat

Sebelum kita memulai coding, pastikan untuk menyiapkan hal berikut:

  1. Aspose.Cells untuk .NET: Unduh Di Sini atau menginstalnya melalui NuGet.
  2. Berkas Excel yang dipetakan XML: Anda memerlukan berkas Excel (.xlsx) dengan peta XML yang sudah tersedia.
  3. Lingkungan Pengembangan: Panduan ini dirancang untuk Visual Studio, tetapi editor C# lainnya juga dapat digunakan.
  4. Lisensi Aspose: Anda dapat memperoleh lisensi sementara Di Sini jika Anda membutuhkannya.

Menyiapkan Lingkungan Pengembangan Anda

Mulailah dengan mengimpor namespace yang diperlukan dalam berkas kode Anda:

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

Dengan mengimpor paket ini, Anda menyiapkan lingkungan Anda untuk mengakses dan memanipulasi buku kerja dan lembar kerjanya.

Langkah 1: Muat File Excel Anda

Pertama, Anda perlu memuat file Excel yang berisi pemetaan XML:

// Tentukan direktori untuk file sumber
string sourceDir = "Your Document Directory"; // Perbarui jalur sesuai kebutuhan

// Muat file Excel
Workbook workbook = new Workbook(sourceDir + "sampleXmlMapQuery.xlsx");

Di Sini, Workbook mewakili keseluruhan berkas Excel Anda, yang Anda muat menggunakan jalur berkasnya.

Langkah 2: Akses Peta XML

Setelah berkas Anda dimuat, akses peta XML dalam buku kerja:

// Akses peta XML pertama di buku kerja
XmlMap xmlMap = workbook.Worksheets.XmlMaps[0];

Ini akan mengambil peta XML pertama dari buku kerja Anda. Jika buku kerja Anda berisi beberapa peta, sesuaikan indeks sesuai kebutuhan.

Langkah 3: Pilih Lembar Kerja

Selanjutnya, akses lembar kerja yang berisi data XML yang dipetakan:

// Akses lembar kerja pertama di buku kerja
Worksheet worksheet = workbook.Worksheets[0];

Dalam kasus ini, kami memilih lembar kerja pertama, tetapi Anda dapat dengan mudah menargetkan lembar kerja lain seperlunya.

Langkah 4: Menanyakan Peta XML

Sekarang, mari kita kueri peta XML menggunakan jalur XML. Misalnya, jika Anda ingin mengambil data dari /MiscData jalur, Anda akan melakukan:

// Menanyakan peta XML menggunakan jalur
Console.WriteLine("Querying XML Map from Path - /MiscData");
ArrayList results = worksheet.XmlMapQuery("/MiscData", xmlMap);

Metode ini mengambil jalur XML dan mengambil data terkait ke dalam ArrayList.

Langkah 5: Menampilkan Hasil Kueri

Sekarang setelah Anda memiliki data yang ditanyakan, mari cetak hasilnya ke konsol:

// Keluarkan hasil query
foreach (var result in results)
{
    Console.WriteLine(result);
}

Perulangan ini memungkinkan Anda untuk melihat semua item yang diambil dari jalur XML.

Langkah 6: Menanyakan Jalur XML Bersarang

Anda dapat mempersempit kueri untuk menargetkan data yang lebih spesifik. Misalnya, jika Anda tertarik dengan informasi warna yang terdapat di bawah /MiscData/row/Color, Anda akan menyesuaikan kueri Anda seperti ini:

// Menanyakan jalur XML bersarang
Console.WriteLine("Querying XML Map from Path - /MiscData/row/Color");
results = worksheet.XmlMapQuery("/MiscData/row/Color", xmlMap);

Langkah 7: Menampilkan Hasil Kueri Bersarang

Terakhir, mari kita tampilkan data dari jalur spesifik ini:

// Keluarkan hasil dari kueri jalur bersarang
foreach (var result in results)
{
    Console.WriteLine(result);
}

Perulangan ini akan mencetak setiap item dari kueri bersarang, yang menunjukkan kepada Anda data yang ditargetkan.

Kesimpulan

Dalam tutorial ini, kami mempelajari cara mengkueri data XML yang dipetakan dalam berkas Excel menggunakan Aspose.Cells untuk .NET. Kemampuan ini sangat berharga bagi pengembang yang ingin mengekstrak data XML tertentu secara dinamis. Dengan pengetahuan dasar ini, Anda kini dapat mengimplementasikan kueri XML yang lebih kompleks dan bahkan bekerja dengan beberapa pemetaan XML dalam proyek Excel Anda.

Pertanyaan yang Sering Diajukan

Bisakah saya memetakan beberapa file XML dalam satu buku kerja Excel?

Ya, Aspose.Cells mendukung pengelolaan beberapa peta XML dalam satu buku kerja.

Bagaimana jika jalur XML tidak ada di peta?

Jika Anda menanyakan jalur yang tidak valid, XmlMapQuery metode akan mengembalikan ArrayList kosong.

Apakah lisensi diperlukan untuk menggunakan Aspose.Cells untuk .NET?

Ya, Anda memerlukan lisensi untuk fungsionalitas penuh. uji coba gratis dan sebuah lisensi sementara tersedia.

Bisakah saya menyimpan data yang ditanyakan ke file Excel baru?

Tentu saja! Anda dapat mengekstrak data dan menyimpannya ke berkas Excel lain atau mengekspornya ke berbagai format yang didukung oleh Aspose.Cells.

Apakah kueri peta XML didukung dalam format selain Excel (.xlsx)?

Pemetaan XML terutama didukung dalam file .xlsx, dan fungsionalitas untuk format lain mungkin terbatas.