giriiş
Excel’de .NET kullanarak XML verileriyle verimli bir şekilde çalışmak istediniz mi? Elektronik tablo düzenleme için güçlü bir kütüphane olan Aspose.Cells for .NET ile Excel dosyalarındaki XML haritalarıyla etkileşim kurmak sorunsuz hale geliyor. Bu eğitimde, Excel dosyalarında XML yollarına eşlenen belirli alanlara nasıl sorgu gönderileceğini inceleyeceğiz. Bu, dinamik raporlar oluşturmak veya veri ayıklamayı otomatikleştirmek için idealdir. Adım adım süreci inceleyelim!
Ön koşullar
Kodlamaya başlamadan önce aşağıdakileri hazırladığınızdan emin olun:
- Aspose.Cells for .NET: İndirin Burada veya NuGet üzerinden yükleyin.
- XML eşlemeli bir Excel dosyası: XML eşlemesi zaten mevcut olan bir Excel dosyasına (.xlsx) ihtiyacınız olacak.
- Geliştirme Ortamı: Bu kılavuz Visual Studio için hazırlanmıştır, ancak diğer C# editörleri de çalışacaktır.
- Aspose Lisansı: Geçici bir lisans alabilirsiniz Burada Eğer ihtiyacınız varsa.
Geliştirme Ortamınızı Kurma
Öncelikle gerekli ad alanlarını kod dosyanıza aktarın:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Diagnostics;
using System.Collections;
Bu paketleri içe aktararak, çalışma kitabına ve çalışma sayfalarına erişmek ve bunları düzenlemek için ortamınızı hazırlamış olursunuz.
Adım 1: Excel Dosyanızı Yükleyin
Öncelikle XML eşlemesini içeren bir Excel dosyası yüklemeniz gerekecek:
// Kaynak dosya için dizini tanımlayın
string sourceDir = "Your Document Directory"; // Yolu buna göre güncelleyin
// Excel dosyasını yükleyin
Workbook workbook = new Workbook(sourceDir + "sampleXmlMapQuery.xlsx");
Burada, Workbook
dosya yolunu kullanarak yüklediğiniz tüm Excel dosyanızı temsil eder.
Adım 2: XML Haritasına Erişim
Dosyanız yüklendikten sonra çalışma kitabındaki XML haritasına erişin:
// Çalışma kitabındaki ilk XML haritasına erişin
XmlMap xmlMap = workbook.Worksheets.XmlMaps[0];
Bu, çalışma kitabınızdan ilk XML haritasını alır. Çalışma kitabınız birden fazla harita içeriyorsa, dizini gerektiği gibi ayarlayın.
Adım 3: Çalışma Sayfasını Seçin
Daha sonra eşlenen XML verilerini içeren çalışma sayfasına erişin:
// Çalışma kitabındaki ilk çalışma sayfasına erişin
Worksheet worksheet = workbook.Worksheets[0];
Bu durumda ilk çalışma sayfasını seçiyoruz, ancak gerektiğinde başka bir çalışma sayfasını da kolayca hedefleyebilirsiniz.
Adım 4: XML Haritasını Sorgulayın
Şimdi, XML yolunu kullanarak XML haritasını sorgulayalım. Örneğin, verileri almak istiyorsanız /MiscData
yol, şunu yapardınız:
// Yolu kullanarak XML haritasını sorgulayın
Console.WriteLine("Querying XML Map from Path - /MiscData");
ArrayList results = worksheet.XmlMapQuery("/MiscData", xmlMap);
Bu yöntem XML yolunu alır ve ilgili verileri bir ArrayList’e alır.
Adım 5: Sorgu Sonuçlarını Görüntüle
Artık sorgulanan verilere sahip olduğunuza göre sonuçları konsola yazdıralım:
// Sorgu sonuçlarını çıktı olarak al
foreach (var result in results)
{
Console.WriteLine(result);
}
Bu döngü XML yolundan alınan tüm öğeleri görüntülemenizi sağlar.
Adım 6: İç İçe Geçmiş XML Yolunu Sorgulama
Sorgunuzu daha spesifik verilere odaklanacak şekilde daraltabilirsiniz. Örneğin, altında bulunan renk bilgileriyle ilgileniyorsanız /MiscData/row/Color
, sorgunuzu şu şekilde ayarlayabilirsiniz:
// İç içe geçmiş bir XML yolunu sorgulama
Console.WriteLine("Querying XML Map from Path - /MiscData/row/Color");
results = worksheet.XmlMapQuery("/MiscData/row/Color", xmlMap);
Adım 7: İç İçe Sorgu Sonuçlarını Görüntüle
Son olarak bu belirli yoldaki verileri görüntüleyelim:
// İç içe geçmiş yol sorgusunun sonuçlarını çıktı olarak alın
foreach (var result in results)
{
Console.WriteLine(result);
}
Bu döngü, iç içe sorgudaki her bir öğeyi yazdıracak ve size hedeflenen verileri gösterecektir.
Çözüm
Bu eğitimde, Excel dosyalarında eşlenen XML verilerinin .NET için Aspose.Cells kullanılarak nasıl sorgulanacağını inceledik. Bu özellik, belirli XML verilerini dinamik olarak çıkarmak isteyen geliştiriciler için paha biçilmezdir. Bu temel bilgiyle, artık daha karmaşık XML sorguları uygulayabilir ve hatta Excel projelerinizde birden fazla XML eşlemesiyle çalışabilirsiniz.
SSS
Birden fazla XML dosyasını tek bir Excel çalışma kitabına eşleyebilir miyim?
Evet, Aspose.Cells tek bir çalışma kitabında birden fazla XML haritasının yönetilmesini destekler.
Haritada XML yolu yoksa ne olur?
Geçersiz bir yolu sorgularsanız, XmlMapQuery
metodu boş bir ArrayList döndürecektir.
Aspose.Cells for .NET’i kullanmak için lisans gerekiyor mu?
Evet, tam işlevsellik için bir lisansa ihtiyacınız var. ücretsiz deneme ve bir geçici lisans mevcuttur.
Sorgulanan verileri yeni bir Excel dosyasına kaydedebilir miyim?
Kesinlikle! Verileri çıkarıp başka bir Excel dosyasına kaydedebilir veya Aspose.Cells tarafından desteklenen farklı formatlara aktarabilirsiniz.
XML haritalarının Excel (.xlsx) dışındaki formatlarda sorgulanması destekleniyor mu?
XML eşlemesi öncelikli olarak .xlsx dosyalarında desteklenir ve diğer formatların işlevleri sınırlı olabilir.