StreamReader Kullanmak Yerine C# ile Excel Dosyalarını Nasıl Okunur

StreamReader Neden Excel Dosyalarını Okuyamaz?

StreamReader metin tabanli bir okuyucudur. Belirtilen bir kodlama (UTF-8, ASCII, vb.) kullanarak karakter verilerini satır satır okur ve ikili yapılar veya sıkıştırılmış arşivler hakkında bilgi sahibi değildir. Resmi .NET StreamReader belgeleri bu sınıfın yalnızca karakter kodlu metinler için tasarlandığını doğrular. Excel dosyalari, basit hesap tablolarina benzemekle birlikte, aslinda StreamReader'nin yorumlayamayacagi karmaşık ikili veya ZIP sıkıştırılmış XML yapilaridir.

Bir XLSX dosyasini StreamReader ile actiginizda, esasen bir ZIP arsivini duz metin olarak okumaya calisiyorsunuz. Sonuç, elektronik tablo verileriniz yerine bir ikili gürültü akışıdır.

// This code will NOT work -- demonstrates the problem
using StreamReader reader = new StreamReader("ProductData.xlsx");
string content = reader.ReadLine();
Console.WriteLine(content); // Outputs garbled binary data like "PK♥♦"

// This code will NOT work -- demonstrates the problem
using StreamReader reader = new StreamReader("ProductData.xlsx");
string content = reader.ReadLine();
Console.WriteLine(content); // Outputs garbled binary data like "PK♥♦"

Imports System.IO

' This code will NOT work -- demonstrates the problem
Using reader As New StreamReader("ProductData.xlsx")
    Dim content As String = reader.ReadLine()
    Console.WriteLine(content) ' Outputs garbled binary data like "PK♥♦"
End Using

Bu kod parcasini calistirdiginizda, hesap tablosu satirlarinizi gormek yerine, PK♥♦ gibi ikili karakterlerle ya da benzer gurultuyle karsilasirsiniz. Bu su nedenlerden dolayi olur:

• XLSX dosyaları birden fazla XML dosyası içeren ZIP arşivleridir: çalışma sayfaları, stiller, paylaşılan dizeler, ilişkiler. Open XML SDK belgeleri bu yapının ayrıntılı bir dökümünü sağlar.
• XLS dosyaları özel bir ikili format (BIFF -- Binary Interchange Dosya Biçimi) kullanır
• StreamReader okudugu baytlara bir karakter kodlamasi uygular, her iki format icin anlamsiz ciktilar uretir

Bir .NET Projesine IronXL Nasıl Kurulur?

IronXL, Microsoft Excel'in kurulu olmasına gerek kalmadan Excel dosyalarını okuyabilen, yazabilen ve oluşturabilen bir .NET kütüphanesidir. XLSX, XLS, XLSM, CSV ve TSV formatlarını destekler ve Windows, Linux, macOS ve Docker konteynerlerinde çalışır.

IronXL'yi kurmak için ya NuGet Paket Yöneticisi Konsolunu ya da .NET CLI'yi kullanın. Paket şu adreste NuGet.org'da IronXL olarak yayımlanmıştır:

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

Kurulumdan sonra, Excel belgeleriyle calismak icin using IronXL; direktifini dosyaniza ekleyin.

Detaylı kurulum adımları ve NuGet yapılandırma seçenekleri için IronXL NuGet kurulum kılavuzunu inceleyin. Bir ücretsiz deneme lisansı mevcuttur, böylece IronXL'yi projenizde satın almadan önce değerlendirebilirsiniz.

Excel Dosyalarını IronXL ile Nasıl Okursunuz?

IronXL, C# dilinde Excel dosyalarını okumanız için sezgisel bir API sunar. StreamReader'den farkli olarak, IronXL Excel'in ic yapisini anlar ve satirlara, sutunlara ve hucre degerlerine temiz bir erişim saglar. IronXL belgeleri tüm desteklenen işlemler için tam API referansı sağlar.

IronXL kullanarak bir Excel dosyasını nasıl okuyacağınız burada üst seviye ifadelerle:

using IronXL;

// Load the Excel file from disk
WorkBook workbook = WorkBook.Load("ProductData.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Read a specific cell by address
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");

// Iterate over a range of cells
foreach (var cell in worksheet["A1:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

// Read a numeric value
decimal price = worksheet["B2"].DecimalValue;
Console.WriteLine($"Price: {price:C}");

using IronXL;

// Load the Excel file from disk
WorkBook workbook = WorkBook.Load("ProductData.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Read a specific cell by address
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");

// Iterate over a range of cells
foreach (var cell in worksheet["A1:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

// Read a numeric value
decimal price = worksheet["B2"].DecimalValue;
Console.WriteLine($"Price: {price:C}");

Imports IronXL

' Load the Excel file from disk
Dim workbook As WorkBook = WorkBook.Load("ProductData.xlsx")
Dim worksheet As WorkSheet = workbook.DefaultWorkSheet

' Read a specific cell by address
Dim cellValue As String = worksheet("A1").StringValue
Console.WriteLine($"Cell A1 contains: {cellValue}")

' Iterate over a range of cells
For Each cell In worksheet("A1:C10")
    Console.WriteLine($"{cell.AddressString}: {cell.Text}")
Next

' Read a numeric value
Dim price As Decimal = worksheet("B2").DecimalValue
Console.WriteLine($"Price: {price:C}")

WorkBook.Load metodu, dosya formatini (XLSX, XLS, XLSM, CSV) otomatik olarak algilar ve tüm karmasik ayrismayi gerceklestirir. Hucrelere, "A1" gibi standart Excel notasyonu veya "A1:C10" gibi araliklar kullanarak erisirsiniz, bu da kodu hesap tablolarina asina olan herkes icin aninda okunabilir hale getirir.

using IronXL;

WorkBook workbook = WorkBook.Load("MultiSheet.xlsx");

// List all worksheets
foreach (WorkSheet sheet in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {sheet.Name}, Rows: {sheet.RowCount}");
}

// Access a sheet by name
WorkSheet summary = workbook.GetWorkSheet("Summary");
string totalRevenue = summary["B20"].StringValue;
Console.WriteLine($"Total Revenue: {totalRevenue}");

// Access a sheet by index
WorkSheet firstSheet = workbook.WorkSheets[0];
int lastRow = firstSheet.RowCount;
Console.WriteLine($"Last row in first sheet: {lastRow}");

using IronXL;

WorkBook workbook = WorkBook.Load("MultiSheet.xlsx");

// List all worksheets
foreach (WorkSheet sheet in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {sheet.Name}, Rows: {sheet.RowCount}");
}

// Access a sheet by name
WorkSheet summary = workbook.GetWorkSheet("Summary");
string totalRevenue = summary["B20"].StringValue;
Console.WriteLine($"Total Revenue: {totalRevenue}");

// Access a sheet by index
WorkSheet firstSheet = workbook.WorkSheets[0];
int lastRow = firstSheet.RowCount;
Console.WriteLine($"Last row in first sheet: {lastRow}");

Imports IronXL

Dim workbook As WorkBook = WorkBook.Load("MultiSheet.xlsx")

' List all worksheets
For Each sheet As WorkSheet In workbook.WorkSheets
    Console.WriteLine($"Sheet: {sheet.Name}, Rows: {sheet.RowCount}")
Next

' Access a sheet by name
Dim summary As WorkSheet = workbook.GetWorkSheet("Summary")
Dim totalRevenue As String = summary("B20").StringValue
Console.WriteLine($"Total Revenue: {totalRevenue}")

' Access a sheet by index
Dim firstSheet As WorkSheet = workbook.WorkSheets(0)
Dim lastRow As Integer = firstSheet.RowCount
Console.WriteLine($"Last row in first sheet: {lastRow}")

Hafıza Akışından Excel Verilerini Nasıl Okursunuz?

Gerçek dünya uygulamaları genellikle disk dosyalarından ziyade akışlardan Excel dosyalarını işlemeyi gerektirir. Yaygın senaryolar arasında web formlarından dosya yüklemelerini işleme, bir veritabanı BLOB sütunundan çalışma kitapları çağırma veya bulut depolama hizmetinden (Azure Blob Storage, AWS S3) indirilen dosyaları işleme yer alır. IronXL bu senaryolari WorkBook.FromStream ile ele alir:

using IronXL;
using System.IO;

// Simulate reading file bytes (e.g., from a database or web upload)
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");

using MemoryStream stream = new MemoryStream(fileBytes);
WorkBook workbook = WorkBook.FromStream(stream);
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Get row and column counts
Console.WriteLine($"Rows: {worksheet.RowCount}, Columns: {worksheet.ColumnCount}");

// Convert to DataTable for database or grid binding
var dataTable = worksheet.ToDataTable(useHeaderRow: true);
Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");

foreach (System.Data.DataRow row in dataTable.Rows)
{
    string productName = row["ProductName"]?.ToString() ?? string.Empty;
    string sku = row["SKU"]?.ToString() ?? string.Empty;
    Console.WriteLine($"Product: {productName}, SKU: {sku}");
}

using IronXL;
using System.IO;

// Simulate reading file bytes (e.g., from a database or web upload)
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");

using MemoryStream stream = new MemoryStream(fileBytes);
WorkBook workbook = WorkBook.FromStream(stream);
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Get row and column counts
Console.WriteLine($"Rows: {worksheet.RowCount}, Columns: {worksheet.ColumnCount}");

// Convert to DataTable for database or grid binding
var dataTable = worksheet.ToDataTable(useHeaderRow: true);
Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");

foreach (System.Data.DataRow row in dataTable.Rows)
{
    string productName = row["ProductName"]?.ToString() ?? string.Empty;
    string sku = row["SKU"]?.ToString() ?? string.Empty;
    Console.WriteLine($"Product: {productName}, SKU: {sku}");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

WorkBook.FromStream herhangi bir Stream kabul eder -- MemoryStream, FileStream veya bir ag akisi. Bu esneklik, yalnızca Excel verilerini okumak için geçici dosyaları diske yazmanız gerekmeyeceği anlamına gelir. DataTable'a dönüştürme, SqlBulkCopy, veri baglama kontrolleri ve raporlamal çerceveleriyle dogrudan entegre olur.

Excel ve CSV Formatları Arasında Nasıl Dönüştürme Yapılır?

StreamReader CSV dosyalarini isleyebilirken, uretim uygulamalarinin genellikle Excel ile CSV arasinda veri tasimasi gerekir. IronXL format donusumunu kolay hale getirir. Excel verilerini CSV'ye aktarmanız veya CSV verilerini bir çalışma kitabına ithal etmeniz sadece birkaç satır gerektirir:

using IronXL;

// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("SalesData.xlsx");
workbook.SaveAsCsv("output.csv");

// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("legacy-report.csv");
csvWorkbook.SaveAs("converted.xlsx");

// Export a specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("sheet1-export.csv");

using IronXL;

// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("SalesData.xlsx");
workbook.SaveAsCsv("output.csv");

// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("legacy-report.csv");
csvWorkbook.SaveAs("converted.xlsx");

// Export a specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("sheet1-export.csv");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Bu dönüşümler, kutu formatını değiştirirken verilerinizi korur. Excel'den CSV'ye dönüştürüldüğünde, IronXL varsayılan olarak ilk çalışma sayfasını dışa aktarır; herhangi bir sayfa seçebilirsiniz. CSV'yi Excel'e dönüştürmek, ardından biçimlendirebileceğiniz, formüller ekleyebileceğiniz ve ek veri yazabileceğiniz düzgün yapılandırılmış bir çalışma kitabı oluşturur.

IronXL ile Excel Dosyalarını Nasıl Oluşturur ve Biçimlendirirsiniz?

Excel verilerini okumak iş akışının sadece bir parçasıdır. Birçok uygulama aynı zamanda yeni Excel dosyaları oluşturmayı ve biçimlendirme uygulamayı da gerektirir. IronXL, hücre biçimlendirmesi dahil olmak üzere yazı tipi, renk, kenarlıklar, sayı formatları ve hücre birleştirme destekler:

using IronXL;

// Create a new workbook and worksheet
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Report");

// Write headers with formatting
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Units Sold";
sheet["C1"].Value = "Revenue";

// Apply bold formatting to header row
sheet["A1:C1"].Style.Font.Bold = true;
sheet["A1:C1"].Style.SetBackgroundColor("#4472C4");
sheet["A1:C1"].Style.Font.Color = "#FFFFFF";

// Write data rows
string[] products = { "Widget A", "Widget B", "Widget C" };
int[] units = { 120, 85, 210 };
decimal[] revenues = { 2400.00m, 1700.00m, 4200.00m };

for (int i = 0; i < products.Length; i++)
{
    sheet[$"A{i + 2}"].Value = products[i];
    sheet[$"B{i + 2}"].Value = units[i];
    sheet[$"C{i + 2}"].Value = revenues[i];
    sheet[$"C{i + 2}"].FormatString = "$#,##0.00";
}

// Save the workbook
workbook.SaveAs("FormattedReport.xlsx");
Console.WriteLine("Report created successfully.");

using IronXL;

// Create a new workbook and worksheet
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Report");

// Write headers with formatting
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Units Sold";
sheet["C1"].Value = "Revenue";

// Apply bold formatting to header row
sheet["A1:C1"].Style.Font.Bold = true;
sheet["A1:C1"].Style.SetBackgroundColor("#4472C4");
sheet["A1:C1"].Style.Font.Color = "#FFFFFF";

// Write data rows
string[] products = { "Widget A", "Widget B", "Widget C" };
int[] units = { 120, 85, 210 };
decimal[] revenues = { 2400.00m, 1700.00m, 4200.00m };

for (int i = 0; i < products.Length; i++)
{
    sheet[$"A{i + 2}"].Value = products[i];
    sheet[$"B{i + 2}"].Value = units[i];
    sheet[$"C{i + 2}"].Value = revenues[i];
    sheet[$"C{i + 2}"].FormatString = "$#,##0.00";
}

// Save the workbook
workbook.SaveAs("FormattedReport.xlsx");
Console.WriteLine("Report created successfully.");

Imports IronXL

' Create a new workbook and worksheet
Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workbook.CreateWorkSheet("Report")

' Write headers with formatting
sheet("A1").Value = "Product"
sheet("B1").Value = "Units Sold"
sheet("C1").Value = "Revenue"

' Apply bold formatting to header row
sheet("A1:C1").Style.Font.Bold = True
sheet("A1:C1").Style.SetBackgroundColor("#4472C4")
sheet("A1:C1").Style.Font.Color = "#FFFFFF"

' Write data rows
Dim products As String() = {"Widget A", "Widget B", "Widget C"}
Dim units As Integer() = {120, 85, 210}
Dim revenues As Decimal() = {2400.0D, 1700.0D, 4200.0D}

For i As Integer = 0 To products.Length - 1
    sheet($"A{i + 2}").Value = products(i)
    sheet($"B{i + 2}").Value = units(i)
    sheet($"C{i + 2}").Value = revenues(i)
    sheet($"C{i + 2}").FormatString = "$#,##0.00"
Next

' Save the workbook
workbook.SaveAs("FormattedReport.xlsx")
Console.WriteLine("Report created successfully.")

Mevcut çalışma kitaplarını hem okuyabilme hem de yeni biçimlendirilmiş dosyalar oluşturabilme yeteneği, IronXL'yi .NET uygulamaları için eksiksiz bir Excel çözümü yapar. Desteklenen işlemlerin detaylı bir dökümünü görmek için tam IronXL özellikler sayfasını inceleyin.

IronXL'yi Üretimde Nasıl Lisanslar ve Yerleştirirsiniz?

IronXL geliştirme ve test icin ucretsizdir. Üretim uygulamaları için lisans gereklidir. Geliştirici, Ekip ve Organizasyon seviyelerini kapsayan IronXL lisanslama seçeneklerini uygulama gereksinimlerinize göre ürün sayfasında inceleyebilirsiniz.

Satın aldıktan sonra, herhangi bir IronXL çağrısından önce lisans anahtarınızı kodda uygulayın:

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

Imports IronXl

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

Alternatif olarak, dağıtim ortaminizda IRONXL_LICENSE_KEY ortam degiskenini ayarlayin ve IronXL bunu otomatik olarak algilayacaktir. Anahtarların hardcoded edilmesinin kabul edilemez olduğu kapalı kutu dağıtımları (Docker, Kubernetes) ve bulut ortamları için önerilen yaklaşım budur.

Değerlendirme amaçları için, [ücretsiz deneme lisansı] tam işlevsellik sağlar, böylece IronXL'yi satın almadan önce belirli iş yüklerinize karşı doğrulayabilirsiniz. Deneme, kredi kartı olmadan mevcuttur ve hemen etkinleşir.

Microsoft.Office.Interop.Excel gibi alternatiflere kıyasla, IronXL'nin birkaç dağıtım avantajı vardır:

• Sunucuda Microsoft Excel kurulumu gereksinimi yoktur
• Linux ve Docker ile uyumludur -- bulut tabanlı uygulamalar için kritiktir
• COM nesne yaşam döngüsü yönetimi veya daire iş parçacığı sorunları yoktur
• Sunucu ortamlarında daha hızlı başlangıç ve daha düşük bellek kullanımı
• Desteklenen tüm platformlarda tutarlı davranış

Bu özellikler, IronXL'yi herhangi bir üretimde Excel dosyalarını işlemek için .NET uygulaması için pratik bir seçim yapar, ister yerel ister bulutta.