C#'da Excel Verilerini Nasıl İçe Alır, Okur ve Manipüle Edersiniz

StreamReader Excel Dosyalarını Neden Okuyamaz?

StreamReader, belirtilen bir kodlama kullanarak karakter verilerini satır satır okuyarak metin dosyaları için tasarlanmıştır. Elektronik tablo görünümüne rağmen, Excel dosyaları karmaşık ikili veya ZIP ile sıkıştırılmış XML yapılarıdır ve StreamReader bunları yorumlayamaz. Modern XLSX dosyaları Office Open XML standardını takip ederken, eski XLS dosyaları özel ikili bir format kullanır.

static void Main(string[] args)
{
 // This code will NOT work - demonstrates the problem
 using (StreamReader reader = new StreamReader("ProductData.xlsx"))
 {
    string content = reader.ReadLine(); // Attempts to read Excel as text
    Console.WriteLine(content); // Outputs garbled binary data
 }
}

static void Main(string[] args)
{
 // This code will NOT work - demonstrates the problem
 using (StreamReader reader = new StreamReader("ProductData.xlsx"))
 {
    string content = reader.ReadLine(); // Attempts to read Excel as text
    Console.WriteLine(content); // Outputs garbled binary data
 }
}

Sub Main(ByVal args As String())
    ' This code will NOT work - demonstrates the problem
    Using reader As New StreamReader("ProductData.xlsx")
        Dim content As String = reader.ReadLine() ' Attempts to read Excel as text
        Console.WriteLine(content) ' Outputs garbled binary data
    End Using
End Sub

Bu kod parçasını çalıştırdığınızda, elektronik tablo verilerinizi görmek yerine "PK♥♦" veya benzeri karakterler gibi ikili veri ile karşılaşacaksınız. Bu durum, XLSX dosyalarının birden çok XML dosyası içeren ZIP arşivleri olması ve XLS dosyalarının ise patentli bir ikili format kullanması nedeniyle gerçekleşir. StreamReader düz metin bekler ve bu karmaşık yapıları karakter olarak yorumlamaya çalışır, bu da anlamsız çıktılarla sonuçlanır. Konteynerleştirilmiş uygulamalar için, yerel Excel kütüphanelerini veya COM Interop'u kullanmayı denemek, konteynerinize Microsoft Office yüklemeyi gerektirecek ve bu da görüntü boyutunu ve karmaşıklığını önemli ölçüde artıracaktır.

IronXL ile Excel Dosyaları Nasıl Okunur?

IronXL, C# dilinde Excel dosyalarını okumak için basit bir çözüm sunar. StreamReader'dan farklı olarak, IronXL Excel'in iç yapısını anlar ve verilerinize erişmek için sezgisel yöntemler sağlar. Kütüphane, modern, çapraz platform uygulamaları için mükemmel hale getirerek, Windows, Linux, macOS ve Docker konteynerleri destekler. DevOps ekipleri için, IronXL'in sıfır bağımlılık mimarisi, dağıtım sırasında yönetilecek yerel kütüphane veya COM bileşenlerinin olmadığı anlamına gelir.

Öncelikle, NuGet Paket Yöneticisi üzerinden IronXL'i yükleyin:

Install-Package IronXL.Excel

Excel dosyasını doğru şekilde nasıl okuyacağınızı işte böyle yapabilirsiniz:

using IronXL;
// Load the Excel file
WorkBook workbook = WorkBook.Load("sample.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");
// Read a range of cells
foreach (var cell in worksheet["A1:C5"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

using IronXL;
// Load the Excel file
WorkBook workbook = WorkBook.Load("sample.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");
// Read a range of cells
foreach (var cell in worksheet["A1:C5"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

Imports IronXL

' Load the Excel file
Dim workbook As WorkBook = WorkBook.Load("sample.xlsx")
Dim worksheet As WorkSheet = workbook.DefaultWorkSheet
' Read specific cell values
Dim cellValue As String = worksheet("A1").StringValue
Console.WriteLine($"Cell A1 contains: {cellValue}")
' Read a range of cells
For Each cell In worksheet("A1:C5")
    Console.WriteLine($"{cell.AddressString}: {cell.Text}")
Next

Bu kod, Excel dosyanızı başarıyla yükler ve hücre değerlerine temiz bir erişim sağlar. WorkBook.Load yöntemi, dosya formatını (XLSX, XLS, XLSM, CSV) otomatik olarak algılar ve tüm karmaşık ayrıştırma işlemlerini dahili olarak yönetir. Excel'e aşina olan herkes için kodu sezgisel hale getirerek, "A1" gibi tanıdık Excel notasyonunu veya "A1:C5" gibi aralıkları kullanarak hücrelere erişebilirsiniz.

Konteynerleştirilmiş dağıtımlar için, Excel işleme yeteneklerini doğrulayan sağlık kontrol uç noktalarını kolayca ekleyebilirsiniz:

// Health check endpoint for containerized apps
public async Task<IActionResult> HealthCheck()
{
    try
    {
        // Test Excel functionality
        using var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        var sheet = workbook.CreateWorkSheet("HealthCheck");
        sheet["A1"].Value = DateTime.UtcNow;

        // Convert to byte array for validation
        var bytes = workbook.ToByteArray();
        return Ok(new { 
            status = "healthy", 
            excelSupport = true,
            timestamp = DateTime.UtcNow 
        });
    }
    catch (Exception ex)
    {
        return StatusCode(503, new { 
            status = "unhealthy", 
            error = ex.Message 
        });
    }
}

// Health check endpoint for containerized apps
public async Task<IActionResult> HealthCheck()
{
    try
    {
        // Test Excel functionality
        using var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        var sheet = workbook.CreateWorkSheet("HealthCheck");
        sheet["A1"].Value = DateTime.UtcNow;

        // Convert to byte array for validation
        var bytes = workbook.ToByteArray();
        return Ok(new { 
            status = "healthy", 
            excelSupport = true,
            timestamp = DateTime.UtcNow 
        });
    }
    catch (Exception ex)
    {
        return StatusCode(503, new { 
            status = "unhealthy", 
            error = ex.Message 
        });
    }
}

Imports System
Imports System.Threading.Tasks
Imports Microsoft.AspNetCore.Mvc

' Health check endpoint for containerized apps
Public Async Function HealthCheck() As Task(Of IActionResult)
    Try
        ' Test Excel functionality
        Using workbook = WorkBook.Create(ExcelFileFormat.XLSX)
            Dim sheet = workbook.CreateWorkSheet("HealthCheck")
            sheet("A1").Value = DateTime.UtcNow

            ' Convert to byte array for validation
            Dim bytes = workbook.ToByteArray()
            Return Ok(New With {
                .status = "healthy",
                .excelSupport = True,
                .timestamp = DateTime.UtcNow
            })
        End Using
    Catch ex As Exception
        Return StatusCode(503, New With {
            .status = "unhealthy",
            .error = ex.Message
        })
    End Try
End Function

Hafıza Akışlarından Excel Nasıl Okunur?

Gerçek dünya uygulamaları genellikle Excel dosyalarını disk dosyalarından ziyade akışlardan işlemelidir. Yaygın senaryolar arasında web yüklemelerini yönetme, veritabanlarından dosya alma veya AWS S3 veya Azure Blob Storage gibi bulut depolamadan veri işleme yer alır. IronXL bu durumları sorunsuz bir şekilde yönetir:

using IronXL;
using System.IO;
// Read Excel from a memory stream
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");
using (MemoryStream stream = new MemoryStream(fileBytes))
{
    WorkBook workbook = WorkBook.FromStream(stream);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    // Process the data
    int rowCount = worksheet.RowCount;
    Console.WriteLine($"The worksheet has {rowCount} rows");
    // Read all data into a DataTable
    var dataTable = worksheet.ToDataTable(false);
    // Display DataTable row count 
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
}

using IronXL;
using System.IO;
// Read Excel from a memory stream
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");
using (MemoryStream stream = new MemoryStream(fileBytes))
{
    WorkBook workbook = WorkBook.FromStream(stream);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    // Process the data
    int rowCount = worksheet.RowCount;
    Console.WriteLine($"The worksheet has {rowCount} rows");
    // Read all data into a DataTable
    var dataTable = worksheet.ToDataTable(false);
    // Display DataTable row count 
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
}

Imports IronXL
Imports System.IO

' Read Excel from a memory stream
Dim fileBytes As Byte() = File.ReadAllBytes("ProductData.xlsx")
Using stream As New MemoryStream(fileBytes)
    Dim workbook As WorkBook = WorkBook.FromStream(stream)
    Dim worksheet As WorkSheet = workbook.DefaultWorkSheet
    ' Process the data
    Dim rowCount As Integer = worksheet.RowCount
    Console.WriteLine($"The worksheet has {rowCount} rows")
    ' Read all data into a DataTable
    Dim dataTable = worksheet.ToDataTable(False)
    ' Display DataTable row count 
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows")
End Using

FromStream yöntemi, bir MemoryStream, FileStream veya ağ akışı olup olmadığını dikkate almadan herhangi bir akış türünü kabul eder. Bu esneklik, Excel dosyalarını diske kaydetmeden önce çeşitli kaynaklardan işlemenize olanak tanır. Örnek ayrıca çalışma sayfası verilerini bir DataTable'a dönüştürmeyi de göstermektedir; bu da veritabanları ve veri bağlama senaryolarıyla sorunsuz bir şekilde bütünleşir. Mikroservis mimarileri için, bu akış tabanlı yaklaşım, disk G/Ç'yi en aza indirir ve performansı artırır.

[HttpPost("upload")]
public async Task<IActionResult> ProcessExcelUpload(IFormFile file)
{
    if (file == null || file.Length == 0)
        return BadRequest("No file uploaded");

    using var stream = new MemoryStream();
    await file.CopyToAsync(stream);
    stream.Position = 0;

    var workbook = WorkBook.FromStream(stream);
    var worksheet = workbook.DefaultWorkSheet;

    // Process and return results
    var data = worksheet.ToDataSet();
    return Ok(new { 
        sheets = workbook.WorkSheets.Count,
        rows = worksheet.RowCount,
        processed = DateTime.UtcNow
    });
}

[HttpPost("upload")]
public async Task<IActionResult> ProcessExcelUpload(IFormFile file)
{
    if (file == null || file.Length == 0)
        return BadRequest("No file uploaded");

    using var stream = new MemoryStream();
    await file.CopyToAsync(stream);
    stream.Position = 0;

    var workbook = WorkBook.FromStream(stream);
    var worksheet = workbook.DefaultWorkSheet;

    // Process and return results
    var data = worksheet.ToDataSet();
    return Ok(new { 
        sheets = workbook.WorkSheets.Count,
        rows = worksheet.RowCount,
        processed = DateTime.UtcNow
    });
}

Imports System.IO
Imports Microsoft.AspNetCore.Mvc

<HttpPost("upload")>
Public Async Function ProcessExcelUpload(file As IFormFile) As Task(Of IActionResult)
    If file Is Nothing OrElse file.Length = 0 Then
        Return BadRequest("No file uploaded")
    End If

    Using stream As New MemoryStream()
        Await file.CopyToAsync(stream)
        stream.Position = 0

        Dim workbook = WorkBook.FromStream(stream)
        Dim worksheet = workbook.DefaultWorkSheet

        ' Process and return results
        Dim data = worksheet.ToDataSet()
        Return Ok(New With {
            .sheets = workbook.WorkSheets.Count,
            .rows = worksheet.RowCount,
            .processed = DateTime.UtcNow
        })
    End Using
End Function

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

StreamReader CSV dosyalarını işleyebilse de, çoğu zaman Excel ve CSV formatları arasında dönüştürme yapmanız gerekebilir. IronXL, bu dönüşümü kolaylaştırır, bu da özellikle DevOps iş akışlarında yaygın olan ETL boru hatları ve veri entegrasyon senaryoları için kullanışlıdır.

using IronXL;
// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("data.xlsx");
workbook.SaveAsCsv("output.csv");
// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv");
csvWorkbook.SaveAs("output.xlsx");
// Export specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("worksheet1.csv");

using IronXL;
// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("data.xlsx");
workbook.SaveAsCsv("output.csv");
// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv");
csvWorkbook.SaveAs("output.xlsx");
// Export specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("worksheet1.csv");

Imports IronXL

' Load an Excel file and save as CSV
Dim workbook As WorkBook = WorkBook.Load("data.xlsx")
workbook.SaveAsCsv("output.csv")

' Load a CSV file and save as Excel
Dim csvWorkbook As WorkBook = WorkBook.LoadCSV("input.csv")
csvWorkbook.SaveAs("output.xlsx")

' Export specific worksheet to CSV
Dim worksheet As WorkSheet = workbook.WorkSheets(0)
worksheet.SaveAsCsv("worksheet1.csv")

Bu dönüşümler, dosya formatını değiştirirken verilerinizi korur. Excel'i CSV'ye dönüştürürken, IronXL varsayılan olarak ilk çalışma sayfasını düzleştirir, ancak hangi çalışma sayfasını dışa aktaracağınızı belirtebilirsiniz. CSV'den Excel'e dönüştürme, veri türlerini koruyan ve gelecekteki formatlama ve formül eklemeleri sağlayan düzgün formatlanmış bir elektronik tablo oluşturur.

Otomatik veri hatları için, JSON'a veya XML formatlarına da aktarım yapabilirsiniz:

// Export Excel to multiple formats for data pipelines
var workbook = WorkBook.Load("report.xlsx");

// Export to JSON for API responses
string jsonData = workbook.ToJson();

// Export to HTML for web display
workbook.SaveAsHtml("report.html");

// Export to XML for integration systems
workbook.SaveAsXml("report.xml");

// Export specific range to DataTable for database insertion
var dataTable = workbook.DefaultWorkSheet["A1:D10"].ToDataTable();

// Export Excel to multiple formats for data pipelines
var workbook = WorkBook.Load("report.xlsx");

// Export to JSON for API responses
string jsonData = workbook.ToJson();

// Export to HTML for web display
workbook.SaveAsHtml("report.html");

// Export to XML for integration systems
workbook.SaveAsXml("report.xml");

// Export specific range to DataTable for database insertion
var dataTable = workbook.DefaultWorkSheet["A1:D10"].ToDataTable();

' Export Excel to multiple formats for data pipelines
Dim workbook = WorkBook.Load("report.xlsx")

' Export to JSON for API responses
Dim jsonData As String = workbook.ToJson()

' Export to HTML for web display
workbook.SaveAsHtml("report.html")

' Export to XML for integration systems
workbook.SaveAsXml("report.xml")

' Export specific range to DataTable for database insertion
Dim dataTable = workbook.DefaultWorkSheet("A1:D10").ToDataTable()

Container Dağıtımı En İyi Uygulamaları

Excel işleme uygulamalarını devreye alan DevOps mühendisleri için, IronXL çeşitli avantajlar sunar. Excel işlemi için optimize edilmiş, üretime hazır bir Dockerfile:

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

# Install any required system fonts for Excel rendering
RUN apt-get update && apt-get install -y \
    fontconfig \
    libfreetype6 \
    && rm -rf /var/lib/apt/lists/*

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["YourApp.csproj", "."]
RUN dotnet restore
COPY . .
RUN dotnet build -c Release -o /app/build

FROM build AS publish
RUN dotnet publish -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .

# Set environment variables for IronXL
ENV IRONXL_LICENSE_KEY=${IRONXL_LICENSE_KEY}
ENV DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=false

ENTRYPOINT ["dotnet", "YourApp.dll"]

Bu Dockerfile, Excel işleme uygulamanızın azami bağımlılıkla konteynerlerde sorunsuz çalışmasını sağlar. Lisanslama, farklı dağıtım ortamları arasında yönetimi kolaylaştıran ortam değişkenleri aracılığıyla yapılır.

C#'te Excel İşleme için Sıradaki Adımlar Nedir?

StreamReader'nin Excel dosyalarını işleyememesinin nedeni, düz metin ve Excel'in karmaşık dosya yapısı arasındaki temel farktan kaynaklanır. StreamReader, CSV ve diğer metin biçimleri için mükemmel çalışsa da, gerçek Excel dosyaları içindeki ikili ve XML yapılarını anlayabilen IronXL gibi özel bir kütüphane gerektirir.

IronXL, sezgisel API'si, kapsamlı format desteği ve kesintisiz akış işleme yetenekleri ile kapsamlı bir çözüm sunar. İster web uygulamaları, masaüstü yazılımları veya bulut hizmetleri geliştiriyor olun, IronXL tüm platformlarda Excel dosyalarını güvenilir bir şekilde işler. Kütüphanenin koşullu biçimlendirme, grafikler, formüller ve gelişmiş Excel özellikleri desteği, onu kurumsal uygulamalar için eksiksiz bir çözüm haline getirir.

DevOps ekipleri için, IronXL'in konteyner dostu mimarisi, minimal sistem bağımlılıkları ve sağlam performans özellikleri, onu modern bulut tabanlı uygulamalar için ideal bir tercih yapar. Kütüphane, yatay ölçeklendirme destekler, Kubernetes podları içinde sorunsuz çalışır ve CI/CD boru hatlarıyla iyi entegre olur.

Excel dosyaları ile düzgün bir şekilde çalışmaya hazır mısınız? IronXL'in ücretsiz deneme sürümünü indirin ve projenizin ihtiyaçlarına en uygun olanı seçin. Kütüphane, geliştirme, hazırlık ve üretim dağıtımlarını kapsayan esnek lisanslama seçenekleri sunmaktadır ve kapsüllenmiş ortamlar ve bulut tabanlı uygulamalar için seçenekler içermektedir.