ExcelDataReader Excel Dosyalarını Yazıyor: Neden Yapamıyor ve IronXL Bunu Nasıl Çözüyor

ExcelDataReader Excel Çalışma Kitabı Verilerini Yazabilir mi?

Hayır. ExcelDataReader tasarım gereği yalnızca okuma kütüphanesidir ve bu sınırlama kasten yapılandırılmıştır. Resmi ExcelDataReader GitHub deposu, projeyi açık bir şekilde "Microsoft Excel dosyalarını okumak için bir kütüphane" olarak tanımlar -- yazma API'si yok, kaydetme metodu yok ve kamuya açık arayüzde hiçbir yerde hücre değeri ayarlayıcısı yoktur. Bunu kendiniz doğrulayabilirsiniz: Paket açıklamasının yalnızca okuma kapsamını vurguladığı ExcelDataReader NuGet paketi sayfasına göz atarak.

ExcelDataReader, okuma için XLS, XLSX ve CSV formatlarını destekler ve bu işi verimli bir şekilde yapar. Kütüphane, ADO.NET'teki IDataReader'a benzer bir akış, ileriye yönelik okuyucu deseni sunar. Bu mimari, büyük veri setlerini hızla çıkarmak için iyi bir şekilde uygundur, ancak Excel yazımının gerektirdiği rastgele erişimli, değiştirilebilir modelle temel olarak uyumsuzdur.

Aşağıdaki kod, ExcelDataReader ile karşılaştığınız sınırlamayı göstermektedir:

using ExcelDataReader;
using System.Text;

// Register the encoding provider required for .NET 5+
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

using var stream = File.Open("source.xlsx", FileMode.Open, FileAccess.Read);
using var reader = ExcelReaderFactory.CreateReader(stream);

while (reader.Read())
{
    string cellValue = reader.GetString(0); // Read a cell value
    Console.WriteLine(cellValue);
    // There is no Write(), Save(), or SetCellValue() method here
}

using ExcelDataReader;
using System.Text;

// Register the encoding provider required for .NET 5+
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

using var stream = File.Open("source.xlsx", FileMode.Open, FileAccess.Read);
using var reader = ExcelReaderFactory.CreateReader(stream);

while (reader.Read())
{
    string cellValue = reader.GetString(0); // Read a cell value
    Console.WriteLine(cellValue);
    // There is no Write(), Save(), or SetCellValue() method here
}

Imports ExcelDataReader
Imports System.Text
Imports System.IO

' Register the encoding provider required for .NET 5+
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance)

Using stream = File.Open("source.xlsx", FileMode.Open, FileAccess.Read)
    Using reader = ExcelReaderFactory.CreateReader(stream)
        While reader.Read()
            Dim cellValue As String = reader.GetString(0) ' Read a cell value
            Console.WriteLine(cellValue)
            ' There is no Write(), Save(), or SetCellValue() method here
        End While
    End Using
End Using

Read() çağrısından sonra, basitçe hiçbir eşdeğer Write() veya Save() karşılığı yoktur. Uygulamanız rapor üretmek, tablo hücrelerini güncellemek, verileri XLSX'e aktarmak, formüller uygulamak veya şablonları işlemek gerektiğinde, ExcelDataReader size boş bir araç kutusu bırakır.

Bu bir hata değil. Bu, kasıtlı bir kapsam kararıdır. ExcelDataReader bir şeyi iyi yapar ve orada durur. Excel'e veri yazmayı içeren herhangi bir iş akışı tamamen farklı bir kütüphane gerektirir.

IronXL Yazma Sorununu Nasıl Çözer?

IronXL, herhangi bir Microsoft Office kurulumu olmadan Excel dosyalarını okuma, oluşturma, düzenleme ve kaydetme için birleştirilmiş bir API sağlar. Kütüphane, bir Excel çalışma kitabını tamamen değiştirilebilir, bellekteki bir nesne grafiği olarak ele alır. Bir çalışma kitabını yüklersiniz veya oluşturursunuz, referansa göre herhangi bir hücreye gidersiniz, değer veya formüller belirlersiniz, stiller uygularsınız, sonra SaveAs() çağrısında bulunursunuz -- bu, bir insanın Excel'de nasıl çalışacağına ayna tutan bir iş akışıdır.

IronXL, hem giriş hem de çıkış için XLSX, XLS, CSV, TSV ve JSON formatlarını destekler. .NET 10, .NET Standard ve .NET Framework üzerinde çalışır, bu da onu konsol uygulamaları, ASP.NET Core web API'leri, masaüstü araçları ve arka plan işlem hizmetleri için uygun hale getirir.

Install-Package IronXL.Excel

dotnet add package IronXL.Excel

using IronXL;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Report");

// Write header row
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Quantity";
sheet["C1"].Value = "Unit Price";

// Write a data row
sheet["A2"].Value = "Widget";
sheet["B2"].Value = 150;
sheet["C2"].Value = 9.99;

workBook.SaveAs("report.xlsx");
Console.WriteLine("Workbook saved.");

using IronXL;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Report");

// Write header row
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Quantity";
sheet["C1"].Value = "Unit Price";

// Write a data row
sheet["A2"].Value = "Widget";
sheet["B2"].Value = 150;
sheet["C2"].Value = 9.99;

workBook.SaveAs("report.xlsx");
Console.WriteLine("Workbook saved.");

Imports IronXL

Dim workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workBook.CreateWorkSheet("Report")

' Write header row
sheet("A1").Value = "Product"
sheet("B1").Value = "Quantity"
sheet("C1").Value = "Unit Price"

' Write a data row
sheet("A2").Value = "Widget"
sheet("B2").Value = 150
sheet("C2").Value = 9.99

workBook.SaveAs("report.xlsx")
Console.WriteLine("Workbook saved.")

Tek Bir IronXL Akışında Okuma ve Yazma Nasıl Yapılır?

Yaygın bir gereksinim, mevcut bir Excel dosyasını okumak, verilerini dönüştürmek ve sonuçları tekrar yazmaktır. ExcelDataReader sadece ilk adımı gerçekleştirir, bu da ikinci bir kütüphane eklemeniz gerektiği anlamına gelir -- gereksiz bir karmaşıklık bu, bağımlılık yönetimi yükü ve olası sürüm çatışmaları ekler.

IronXL, tüm hattı kapsamaktadır. Aşağıdaki örnek, bir kaynak dosyayı yükler, A sütunundaki değerleri okur, dönüştürür ve değiştirilen çalışma kitabını yeni bir dosya olarak kaydeder:

using IronXL;

WorkBook workBook = WorkBook.Load("source.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Read existing data
string originalValue = sheet["A1"].StringValue;
Console.WriteLine($"Original: {originalValue}");

// Modify existing data
sheet["A1"].Value = originalValue.ToUpper();

// Add new data alongside existing content
sheet["B1"].Value = DateTime.Now.ToString("yyyy-MM-dd");
sheet["C1"].Formula = "=LEN(A1)";

workBook.SaveAs("modified.xlsx");
Console.WriteLine("Modified workbook saved.");

using IronXL;

WorkBook workBook = WorkBook.Load("source.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Read existing data
string originalValue = sheet["A1"].StringValue;
Console.WriteLine($"Original: {originalValue}");

// Modify existing data
sheet["A1"].Value = originalValue.ToUpper();

// Add new data alongside existing content
sheet["B1"].Value = DateTime.Now.ToString("yyyy-MM-dd");
sheet["C1"].Formula = "=LEN(A1)";

workBook.SaveAs("modified.xlsx");
Console.WriteLine("Modified workbook saved.");

Imports IronXL

Dim workBook As WorkBook = WorkBook.Load("source.xlsx")
Dim sheet As WorkSheet = workBook.DefaultWorkSheet

' Read existing data
Dim originalValue As String = sheet("A1").StringValue
Console.WriteLine($"Original: {originalValue}")

' Modify existing data
sheet("A1").Value = originalValue.ToUpper()

' Add new data alongside existing content
sheet("B1").Value = DateTime.Now.ToString("yyyy-MM-dd")
sheet("C1").Formula = "=LEN(A1)"

workBook.SaveAs("modified.xlsx")
Console.WriteLine("Modified workbook saved.")

WorkBook.Load() çağrısı, dosyayı bellekte değiştirilebilir bir nesne olarak okur. Sonra, hücreleri Excel tarzı referanslar kullanarak gezinir, değerleri günceller, formülleri ayarlar ve tek bir kütüphane ve tek bir API deseni içinde kaydedersiniz.

IronXL, Hangi İleri Yazma Özelliklerini Destekler?

Basit hücre atamasının ötesinde, IronXL iş uygulamalarının genellikle ihtiyaç duyduğu Excel yeteneklerinin tüm yelpazesini ortaya çıkarır.

using IronXL;
using IronXL.Styles;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Analytics");

// Write labels
sheet["A1"].Value = "Revenue";
sheet["B1"].Value = "Cost";
sheet["C1"].Value = "Margin";

// Write data
sheet["A2"].Value = 50000;
sheet["B2"].Value = 32000;

// Write a calculated formula
sheet["C2"].Formula = "=A2-B2";

// Apply bold formatting to the header row
sheet["A1:C1"].Style.Font.Bold = true;

// Highlight the margin cell
sheet["C2"].Style.BackgroundColor = "#D4EDDA";
sheet["C2"].Style.Font.Bold = true;

workBook.SaveAs("analytics.xlsx");

using IronXL;
using IronXL.Styles;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Analytics");

// Write labels
sheet["A1"].Value = "Revenue";
sheet["B1"].Value = "Cost";
sheet["C1"].Value = "Margin";

// Write data
sheet["A2"].Value = 50000;
sheet["B2"].Value = 32000;

// Write a calculated formula
sheet["C2"].Formula = "=A2-B2";

// Apply bold formatting to the header row
sheet["A1:C1"].Style.Font.Bold = true;

// Highlight the margin cell
sheet["C2"].Style.BackgroundColor = "#D4EDDA";
sheet["C2"].Style.Font.Bold = true;

workBook.SaveAs("analytics.xlsx");

Imports IronXL
Imports IronXL.Styles

Dim workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workBook.CreateWorkSheet("Analytics")

' Write labels
sheet("A1").Value = "Revenue"
sheet("B1").Value = "Cost"
sheet("C1").Value = "Margin"

' Write data
sheet("A2").Value = 50000
sheet("B2").Value = 32000

' Write a calculated formula
sheet("C2").Formula = "=A2-B2"

' Apply bold formatting to the header row
sheet("A1:C1").Style.Font.Bold = True

' Highlight the margin cell
sheet("C2").Style.BackgroundColor = "#D4EDDA"
sheet("C2").Style.Font.Bold = True

workBook.SaveAs("analytics.xlsx")

using IronXL;

// Load a CSV file as if it were a workbook
WorkBook csvWorkBook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.CSV);
WorkSheet csvSheet = csvWorkBook.DefaultWorkSheet;

// Apply a bold header style to the first row
csvSheet["A1:Z1"].Style.Font.Bold = true;

// Save as XLSX
csvWorkBook.SaveAs("converted.xlsx");
Console.WriteLine("CSV converted to XLSX.");

using IronXL;

// Load a CSV file as if it were a workbook
WorkBook csvWorkBook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.CSV);
WorkSheet csvSheet = csvWorkBook.DefaultWorkSheet;

// Apply a bold header style to the first row
csvSheet["A1:Z1"].Style.Font.Bold = true;

// Save as XLSX
csvWorkBook.SaveAs("converted.xlsx");
Console.WriteLine("CSV converted to XLSX.");

Imports IronXL

' Load a CSV file as if it were a workbook
Dim csvWorkBook As WorkBook = WorkBook.LoadCSV("data.csv", fileFormat:=ExcelFileFormat.CSV)
Dim csvSheet As WorkSheet = csvWorkBook.DefaultWorkSheet

' Apply a bold header style to the first row
csvSheet("A1:Z1").Style.Font.Bold = True

' Save as XLSX
csvWorkBook.SaveAs("converted.xlsx")
Console.WriteLine("CSV converted to XLSX.")

ExcelDataReader ve IronXL Nasıl Yan Yana Karşılaştırılır?

Aşağıdaki tablo, en yaygın Excel geliştirme senaryolarında iki kütüphane arasındaki yetenek farkını özetlemektedir:

ExcelDataReader, yalnızca okuma gereksinimi olduğunda ve ikili boyut önemli olduğunda meşru bir tercih olmaya devam eder. Herhangi bir çıktı senaryosu için IronXL uygun araçtır.

IronXL'i Ne Zaman Kullanmalısınız?

Uygulamanızın Excel dosyalarını üretmesi veya değiştirmesi gerektiğinde IronXL doğru seçim olur. Aşağıdaki senaryolar, ExcelDataReader'ın karşılayamadığı gerçek iş gereksinimlerinden temsilcidir:

• Rapor oluşturma: Veritabanı sorgularından, API yanıtlarından veya bellekteki hesaplamalardan Excel raporları oluşturun. Excel rapor oluşturma kılavuzuna yapılandırılmış bir çalışma için göz atın.
• Veri ihracı: Uygulama verilerini -- koleksiyonları, DataTables veya DataSets -- indirilebilmesi veya arşivlenebilmesi için XLSX dosyasına dönüştürün. DataTable'dan Excel'e kılavuzu exact API'yi gösterir.
• Şablon işleme: Yer tutucu hücreler içeren bir XLSX şablonu yükleyin, bunları dinamik olarak doldurun, ardından doldurulmuş sonucu kaydedin.
• Toplu dosya değişikliği: Çalışma kitapları dizininde yineleme yapın, programlı değişiklikler uygulayın ve her dosyayı kaydedin. IronXL, birden fazla açık çalışma kitabını bağımsız olarak işler.
• Fatura ve finansal belge oluşturma: Formüller, sayı formatlama, birleştirilmiş hücreler ve stil verilmiş başlıklarla yapılandırılmış belgeler oluşturun.
• CSV-to-XLSX dönüşümü: Virgülle ayrılmış yüklemeleri kabul edin, bunları yapılandırılmış çalışma kitaplarına yeniden formatlayın ve kullanıcılara XLSX indirmeleri olarak geri verin.

Önceden okuma kütüphanesi artı bir yazma kütüphanesi veya COM üzerinden Excel otomasyonuna bağımlılık gerektiren iş uygulamaları, yalnızca IronXL ile konsolide edebilir.

Gelişmiş çıktı senaryoları için, koşullu biçimlendirme dokümantasyonu ve grafik oluşturma kılavuzu, biçimlendirme ve görselleştirme yeteneklerinin tam kapsamını ele alır. Lisanslama sayfası üretim dağıtım seçeneklerini belirtir ve tam API referansı her sınıf ve metodu belgeler.

Ücretsiz Bir Deneme ile Nasıl Başlanır?

IronXL, ücretsiz bir geliştirme lisansı altında sunulmaktadır. NuGet paketini yükleyin, yukarıdaki örnekleri kendi dosyalarınıza karşı çalıştırın ve üretim lisansına karar vermeden önce çıktının gereksinimlerinizi karşıladığını doğrulayın.

IronXL başlangıç kılavuzu, kurulum, ilk kullanım modelleri ve çalıştırılabilir kod ile yaygın senaryoları anlatmaktadır. Eğitimler bölümü, okuma iş akışlarını ayrıntılı olarak kapsar ve bu, uygulamanızın hem okuma hem de yazma işlemlerine ihtiyaç duyması durumunda faydalıdır.

Ücretsiz denemeyi başlatın ve tam özellik setine, ihraç formatları, gelişmiş biçimlendirme, formül değerlendirme ve çok sayfalı çalışma kitabı yönetimi dahil, erişin. Kütüphaneyi geniş ölçekte değerlendirilen ekipler için, Iron Suite paketi, IronPDF, IronOCR ve diğer iş verimliliği kütüphanelerini azaltılmış kombine fiyata içerir.

ExcelDataReader Hâlâ Kullanılmaya Değer mi?

ExcelDataReader, iyi bakımı yapılan, net bir amaca sahip açık kaynaklı bir kütüphanedir. Uygulamanız yalnızca Excel dosyalarını okuyorsa ve asla yazmıyorsa -- örneğin, XLSX yüklemelerini bir veritabanına içe aktaran bir veri alım hattı -- ExcelDataReader, makul ve hafif bir tercihtir. Akış modeli, çok büyük dosyalar için bellek açısından verimlidir.

Gereksinimler genişlediğinde sorun ortaya çıkar. Başlangıçta salt okunur içe aktarıcılar olarak başlayan uygulamalar, genellikle onay ihracatları, hata raporları veya orijinal dosyaların değiştirilmiş kopyalarını üretmek üzere gelişir. O noktada, ExcelDataReader'ın kapsam sınırı bir engel haline gelir ve projenin ortasında bir okuma-yazma kütüphanesine geçiş yapmak, başlangıçtan itibaren bir kütüphaneyle başlamak yerine daha rahatsız edici olur.

Başlangıçta IronXL'i seçmek her iki senaryoyu da kapsar. IronXL okuma kılavuzu, IronXL ile okumanın da aynı derecede kolay olduğunu gösterir -- hücre referansları, aralık yineleme, DataSet dışa aktarma ve tür güvenli değer erişimi, hepsi aynı tanıdık API üzerinden çalışır.

Sonraki Adımda Ne Yapmalısınız?

ExcelDataReader bir salt okunur kütüphanedir. Bu kısıtlama tasarım gereğidir ve değişmeyecektir. Projeniz, herhangi bir biçimde Excel dosyalarını yazmayı, değiştirmeyi veya dışa aktarmayı gerektiriyorsa, iki yönlü Excel erişimi için tasarlanmış bir kütüphaneye ihtiyacınız var.

IronXL, Office bağımlılıkları olmadan, COM interop karmaşıklığı olmadan ve birden fazla paketi kırılgan bir çoklu kütüphane yığınına birleştirmeden bu yeteneği sağlar. NuGet'ten yükleyin, mevcut okuma kodunuzu IronXL'ın eşdeğer metotlarıyla değiştirin ve gerektiği yerlerde yazma işlemleri ekleyin -- API, her iki yönde de tutarlıdır.

IronXL belgelerini keşfederek kütüphanenin tam kapsamını anlayın. Belirli görevler için nasıl yapılır kılavuzlarını, örneğin Excel dosyaları yazma, elektronik tablolar oluşturma ve mevcut çalışma kitaplarını okuma, inceleyin. Üretim lisanslamasını değerlendirmeye hazır olduğunuzda, fiyatlandırma ve lisanslama sayfası tüm mevcut seviyeleri listeler.