C# ile Yüklü Olmadan Open Office Excel Dosyalarını Nasıl Okunur

.NET Projesine IronXL Nasıl Kurulur?

Install-Package IronXL.Excel

OpenOffice veya Excel Dosyasını C#'da Nasıl Yükleriz?

IronXL, WorkBook.Load yöntemi aracılığıyla ODS, XLS, XLSX ve CSV dosyalarını aynı şekilde işler. Mutlak veya görece bir dosya yolu verir ve kütüphane yalnızca uzantıdan değil, dosya başlığından biçimi algılar. Bu, .ods adlı bir dosyanın .xlsx olarak yeniden adlandırıldığında hala doğru şekilde okunduğu anlamına gelir.

using IronXL;

// Load an OpenDocument Spreadsheet (.ods) produced by LibreOffice Calc or OpenOffice
WorkBook workbook = WorkBook.Load("quarterly_report.ods");

// Access the first worksheet by index
WorkSheet sheet = workbook.WorkSheets[0];

// Read a cell value
string companyName = sheet["A1"].StringValue;
int recordCount   = sheet["B1"].IntValue;

Console.WriteLine($"Company : {companyName}");
Console.WriteLine($"Records : {recordCount}");

using IronXL;

// Load an OpenDocument Spreadsheet (.ods) produced by LibreOffice Calc or OpenOffice
WorkBook workbook = WorkBook.Load("quarterly_report.ods");

// Access the first worksheet by index
WorkSheet sheet = workbook.WorkSheets[0];

// Read a cell value
string companyName = sheet["A1"].StringValue;
int recordCount   = sheet["B1"].IntValue;

Console.WriteLine($"Company : {companyName}");
Console.WriteLine($"Records : {recordCount}");

Imports IronXL

' Load an OpenDocument Spreadsheet (.ods) produced by LibreOffice Calc or OpenOffice
Dim workbook As WorkBook = WorkBook.Load("quarterly_report.ods")

' Access the first worksheet by index
Dim sheet As WorkSheet = workbook.WorkSheets(0)

' Read a cell value
Dim companyName As String = sheet("A1").StringValue
Dim recordCount As Integer = sheet("B1").IntValue

Console.WriteLine($"Company : {companyName}")
Console.WriteLine($"Records : {recordCount}")

Aynı çağrı XLSX ve XLS dosyalarında çalışır -- sadece yolu değiştirin. WorkBook.Load kaynağın formatından bağımsız olarak aynı güçlü dönüştürülmüş nesneyi döndürür, böylece dosya Microsoft Excel, LibreOffice veya herhangi bir başka ODF uyumlu uygulamadan gelse bile kodunuzun geri kalanı aynı kalır.

Bir Çalışma Sayfasındaki Her Satırı ve Hücreyi Nasıl Okursunuz?

using IronXL;

WorkBook workbook  = WorkBook.Load("customers.xlsx");
WorkSheet worksheet = workbook.WorkSheets[0];

Console.WriteLine($"Total rows    : {worksheet.RowCount}");
Console.WriteLine($"Total columns : {worksheet.ColumnCount}");
Console.WriteLine();

foreach (var row in worksheet.Rows)
{
    foreach (var cell in row)
    {
        if (!cell.IsEmpty)
            Console.Write($"{cell.StringValue,-20}");
    }
    Console.WriteLine();
}

using IronXL;

WorkBook workbook  = WorkBook.Load("customers.xlsx");
WorkSheet worksheet = workbook.WorkSheets[0];

Console.WriteLine($"Total rows    : {worksheet.RowCount}");
Console.WriteLine($"Total columns : {worksheet.ColumnCount}");
Console.WriteLine();

foreach (var row in worksheet.Rows)
{
    foreach (var cell in row)
    {
        if (!cell.IsEmpty)
            Console.Write($"{cell.StringValue,-20}");
    }
    Console.WriteLine();
}

Imports IronXL

Dim workbook As WorkBook = WorkBook.Load("customers.xlsx")
Dim worksheet As WorkSheet = workbook.WorkSheets(0)

Console.WriteLine($"Total rows    : {worksheet.RowCount}")
Console.WriteLine($"Total columns : {worksheet.ColumnCount}")
Console.WriteLine()

For Each row In worksheet.Rows
    For Each cell In row
        If Not cell.IsEmpty Then
            Console.Write($"{cell.StringValue,-20}")
        End If
    Next
    Console.WriteLine()
Next

Hücrelerden Türlenmiş Değerler Nasıl Çıkartılır?

using IronXL;

WorkBook workbook = WorkBook.Load("inventory.xlsx");
WorkSheet sheet   = workbook.GetWorkSheet("Products");

// Typed accessors handle conversion automatically
string  productName = sheet["A2"].StringValue;
int     quantity    = sheet["B2"].IntValue;
decimal unitPrice   = sheet["C2"].DecimalValue;
bool    inStock     = sheet["D2"].BoolValue;
DateTime? lastAudit = sheet["E2"].DateTimeValue;

Console.WriteLine($"Product  : {productName}");
Console.WriteLine($"Qty      : {quantity}");
Console.WriteLine($"Price    : {unitPrice:C}");
Console.WriteLine($"In Stock : {inStock}");
Console.WriteLine($"Audited  : {lastAudit?.ToString("d") ?? "Never"}");

using IronXL;

WorkBook workbook = WorkBook.Load("inventory.xlsx");
WorkSheet sheet   = workbook.GetWorkSheet("Products");

// Typed accessors handle conversion automatically
string  productName = sheet["A2"].StringValue;
int     quantity    = sheet["B2"].IntValue;
decimal unitPrice   = sheet["C2"].DecimalValue;
bool    inStock     = sheet["D2"].BoolValue;
DateTime? lastAudit = sheet["E2"].DateTimeValue;

Console.WriteLine($"Product  : {productName}");
Console.WriteLine($"Qty      : {quantity}");
Console.WriteLine($"Price    : {unitPrice:C}");
Console.WriteLine($"In Stock : {inStock}");
Console.WriteLine($"Audited  : {lastAudit?.ToString("d") ?? "Never"}");

Imports IronXL

Dim workbook As WorkBook = WorkBook.Load("inventory.xlsx")
Dim sheet As WorkSheet = workbook.GetWorkSheet("Products")

' Typed accessors handle conversion automatically
Dim productName As String = sheet("A2").StringValue
Dim quantity As Integer = sheet("B2").IntValue
Dim unitPrice As Decimal = sheet("C2").DecimalValue
Dim inStock As Boolean = sheet("D2").BoolValue
Dim lastAudit As DateTime? = sheet("E2").DateTimeValue

Console.WriteLine($"Product  : {productName}")
Console.WriteLine($"Qty      : {quantity}")
Console.WriteLine($"Price    : {unitPrice:C}")
Console.WriteLine($"In Stock : {inStock}")
Console.WriteLine($"Audited  : {If(lastAudit?.ToString("d"), "Never")}")

Birden Fazla İsimlendirilmiş Çalışma Sayfası ile Nasıl Çalışırsınız?

using IronXL;

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

// Option 1: access by name (throws if the sheet does not exist)
WorkSheet januarySheet = workbook.GetWorkSheet("January");

// Option 2: iterate all sheets in the workbook
foreach (WorkSheet ws in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {ws.Name}  |  Rows: {ws.RowCount}");

    // Read the header row from each sheet
    string header = ws["A1"].StringValue;
    Console.WriteLine($"  Header: {header}");
}

// Option 3: access by zero-based index
WorkSheet lastSheet = workbook.WorkSheets[workbook.WorkSheets.Count - 1];
Console.WriteLine($"Last sheet: {lastSheet.Name}");

using IronXL;

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

// Option 1: access by name (throws if the sheet does not exist)
WorkSheet januarySheet = workbook.GetWorkSheet("January");

// Option 2: iterate all sheets in the workbook
foreach (WorkSheet ws in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {ws.Name}  |  Rows: {ws.RowCount}");

    // Read the header row from each sheet
    string header = ws["A1"].StringValue;
    Console.WriteLine($"  Header: {header}");
}

// Option 3: access by zero-based index
WorkSheet lastSheet = workbook.WorkSheets[workbook.WorkSheets.Count - 1];
Console.WriteLine($"Last sheet: {lastSheet.Name}");

Imports IronXL

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

' Option 1: access by name (throws if the sheet does not exist)
Dim januarySheet As WorkSheet = workbook.GetWorkSheet("January")

' Option 2: iterate all sheets in the workbook
For Each ws As WorkSheet In workbook.WorkSheets
    Console.WriteLine($"Sheet: {ws.Name}  |  Rows: {ws.RowCount}")

    ' Read the header row from each sheet
    Dim header As String = ws("A1").StringValue
    Console.WriteLine($"  Header: {header}")
Next

' Option 3: access by zero-based index
Dim lastSheet As WorkSheet = workbook.WorkSheets(workbook.WorkSheets.Count - 1)
Console.WriteLine($"Last sheet: {lastSheet.Name}")

Birleştirilmiş Hücreler ve Biçimlı Bölgeler Nasıl Yönetilir?

Raporlar ve panolar, sıklıkla başlıklar, gruplandırılmış etiketler ve özet satırlar için birleştirilmiş hücreler kullanır. IronXL, birleştirilmiş bir bölgenin sol üst hücresinden değeri okur, tıpkı Excel'in gösterdiği gibi:

using IronXL;

WorkBook workbook = WorkBook.Load("report_with_merges.xlsx");
WorkSheet sheet   = workbook.DefaultWorkSheet;

// The merged region A1:D1 stores its value in cell A1
string reportTitle = sheet["A1"].StringValue;
Console.WriteLine($"Report title : {reportTitle}");

// Read cell formatting metadata
var titleCell = sheet["A1"];
Console.WriteLine($"Bold         : {titleCell.Style.Font.Bold}");
Console.WriteLine($"Font size    : {titleCell.Style.Font.Height}");

// Scan an entire column for non-empty section headers
foreach (var cell in sheet["A1:A100"])
{
    if (!cell.IsEmpty && cell.Style.Font.Bold)
        Console.WriteLine($"Section header at {cell.AddressString}: {cell.StringValue}");
}

using IronXL;

WorkBook workbook = WorkBook.Load("report_with_merges.xlsx");
WorkSheet sheet   = workbook.DefaultWorkSheet;

// The merged region A1:D1 stores its value in cell A1
string reportTitle = sheet["A1"].StringValue;
Console.WriteLine($"Report title : {reportTitle}");

// Read cell formatting metadata
var titleCell = sheet["A1"];
Console.WriteLine($"Bold         : {titleCell.Style.Font.Bold}");
Console.WriteLine($"Font size    : {titleCell.Style.Font.Height}");

// Scan an entire column for non-empty section headers
foreach (var cell in sheet["A1:A100"])
{
    if (!cell.IsEmpty && cell.Style.Font.Bold)
        Console.WriteLine($"Section header at {cell.AddressString}: {cell.StringValue}");
}

Imports IronXL

Dim workbook As WorkBook = WorkBook.Load("report_with_merges.xlsx")
Dim sheet As WorkSheet = workbook.DefaultWorkSheet

' The merged region A1:D1 stores its value in cell A1
Dim reportTitle As String = sheet("A1").StringValue
Console.WriteLine($"Report title : {reportTitle}")

' Read cell formatting metadata
Dim titleCell = sheet("A1")
Console.WriteLine($"Bold         : {titleCell.Style.Font.Bold}")
Console.WriteLine($"Font size    : {titleCell.Style.Font.Height}")

' Scan an entire column for non-empty section headers
For Each cell In sheet("A1:A100")
    If Not cell.IsEmpty AndAlso cell.Style.Font.Bold Then
        Console.WriteLine($"Section header at {cell.AddressString}: {cell.StringValue}")
    End If
Next

Style özelliği ağacı, OOXML SpreadsheetML spesifikasyonunun yapısını yansıtır, bu yüzden daha önce Open XML SDK ile çalıştıysanız, özellik adları size tanıdık gelecektir. Bununla birlikte, IronXL bu karmaşıklığı temiz bir API ile sarar ve tarafınızdan herhangi bir XML manipülasyonu gerektirmez.

Aynı API ile CSV Dosyalarını Nasıl İçe Aktarırsınız?

Veritabanı dışa aktarımları, CRM sistemleri ve eski uygulamalar tarafından üretilen CSV dosyaları aynı WorkBook.Load çağrısı ile okunabilir. IronXL, dosya içeriğinden ayırıcıyı tahmin eder:

using IronXL;

// Load a comma-separated values file -- same method, same API
WorkBook csvWorkbook  = WorkBook.Load("export.csv");
WorkSheet csvSheet    = csvWorkbook.DefaultWorkSheet;

Console.WriteLine($"CSV rows loaded: {csvSheet.RowCount}");

// Process rows exactly like any other worksheet
foreach (var row in csvSheet.Rows)
{
    string id   = row[0].StringValue;
    string name = row[1].StringValue;
    Console.WriteLine($"{id,-10} {name}");
}

using IronXL;

// Load a comma-separated values file -- same method, same API
WorkBook csvWorkbook  = WorkBook.Load("export.csv");
WorkSheet csvSheet    = csvWorkbook.DefaultWorkSheet;

Console.WriteLine($"CSV rows loaded: {csvSheet.RowCount}");

// Process rows exactly like any other worksheet
foreach (var row in csvSheet.Rows)
{
    string id   = row[0].StringValue;
    string name = row[1].StringValue;
    Console.WriteLine($"{id,-10} {name}");
}

Imports IronXL

' Load a comma-separated values file -- same method, same API
Dim csvWorkbook As WorkBook = WorkBook.Load("export.csv")
Dim csvSheet As WorkSheet = csvWorkbook.DefaultWorkSheet

Console.WriteLine($"CSV rows loaded: {csvSheet.RowCount}")

' Process rows exactly like any other worksheet
For Each row In csvSheet.Rows
    Dim id As String = row(0).StringValue
    Dim name As String = row(1).StringValue
    Console.WriteLine($"{id,-10} {name}")
Next

Yüklendikten sonra, verileri csvWorkbook.SaveAs("output.xlsx") kullanarak XLSX olarak kaydedebilirsiniz. Bu, CSV'den Excel'e dönüşüm hatları için yaygın bir kalıptır -- bir CSV dosyası almak, hesaplanmış sütunlar veya formatlama ile zenginleştirmek ve kullanıcıya formatlı bir XLSX raporu olarak geri döndürmek.

Tab ile ayrılmış dosyalar ya da özel ayraçlar için, biçimi açıkça belirtmek amacıyla WorkBook.LoadCSV("file.tsv", fileFormat: ExcelFileFormat.TSV) kullanın.

IronXL Microsoft.Office.Interop.Excel ile Nasıl Karşılaştırılır?

Excel İşlemeyi Linux ve Docker'a Nasıl Dağıtırsınız?

Sunucu dağıtımları, IronXL'nin Excel'den bağımsızlığının en değerli hale geldiği yerdir. Windows'ta yazdığınız aynı kod, Ubuntu, Alpine Linux veya macOS'ta değiştirilmeden çalışır. Konteynerlenmiş dağıtımlar için Dockerfile'ınız özel bir yapılandırma gerektirmez:

# Standard .NET runtime image -- no Office packages needed
FROM mcr.microsoft.com/dotnet/runtime:10.0
WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "ExcelProcessor.dll"]

# Standard .NET runtime image -- no Office packages needed
FROM mcr.microsoft.com/dotnet/runtime:10.0
WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "ExcelProcessor.dll"]

Azure Functions ve AWS Lambda için, IronXL, yönetilen çalıştırma zamanı içerisinde herhangi bir ek yapılandırma gerektirmeden çalışır. Soğuk başlatma yükü minumumdur çünkü bir COM başlatma adımı yoktur.

İş parçacığı güvenliği yerleşiktir: birden fazla iş parçacığı, koordinasyon olmadan farklı WorkBook örneklerini eşzamanlı olarak açabilir. Kullanıcı yüklemeli elektronik tabloları içeren bir arka plan işinde olduğu gibi, binlerce dosyayı paralel olarak işlemeniz gerekiyorsa, herhangi bir bozulma riski olmadan WorkBook örnekleri havuzunda Parallel.ForEach veya Task.WhenAll kullanabilirsiniz.

Bellek kullanımı tahmin edilebilir kalır çünkü IronXL yalnızca istenen çalışma sayfasını belleğe yükler, başlatma sırasında tüm kitabı değil. Çok büyük dosyalar için bu fark önemlidir: on adet 50MB'lık sayfa içeren bir kitap sadece tek bir sayfayı okumak için 500MB RAM gerektirmez. IronXL performans belgeleri, yüksek hacimli dosya işleme senaryolarını ele almak için ek stratejiler içerir.

Sonraki Adımlarınız Neler?

IronXL'yi projenizde doğrulamanın en hızlı yolu, NuGet paketini yüklemek ve bu kılavuzdaki örnekleri ortamınızdaki gerçek bir dosya karşısında çalıştırmaktır. Bir ücretsiz deneme lisansı tüm özelliklerinizi kod değişikliği gerektirmeden kilitler, üretime hazır olduğunuzda.

Dosya okuma işlemini tamamlayan ilgili IronXL yeteneklerini keşfedin:

• C# ile Excel dosyaları yazın ve oluşturun -- raporlar ve veri dışa aktarımları programlama yoluyla oluşturun
• Hücreleri, satırları ve sütunları biçimlendirin -- kodda renkler, yazı tipleri ve kenarlıklar uygulayın
• C# içinde Excel formülleri ile çalışın -- formül hücrelerini okuyun ve yazın
• Excel'i PDF'ye Dönüştürme .NET'te -- hesap tablosu verilerinden PDF raporları oluşturma
• IronXL API dökümantasyonu -- tüm sınıflar ve metotlar için tam başvuru
• IronXL lisanslama ve fiyatlandırma -- bireysel geliştiriciler ve kurumsal ekipler için seçenekler
• IronXL NuGet sayfası -- tüm proje türleri için kurulum talimatları
• IronXL eğitimleri -- yaygın kullanım senaryoları için adım adım kılavuzlar
• IronXL ile EPPlus'i Karşılaştırın -- özellik ve lisanslama karşılaştırması
• IronXL ürün ana sayfası -- özellik genel bakışı ve başlarken kaynakları

Lisans, çapraz platform desteği veya belirli dosya formatı gereksinimleri hakkında sorular için, IronXL destek ekibi, canlı sohbet ve e-posta aracılığıyla hizmetinizdedir.

Şimdi IronXL ile başlayın.

Ücretsiz Başlayın