Excel dosyalarını programatik olarak kullanmak, C# uygulamalarınıza kattığınız verimlilik ve otomasyon yeteneklerini önemli ölçüde artırabilir. Raporlar oluşturuyor, verileri işliyor veya dinamik olarak karmaşık elektronik tablolar yaratıyor olun, Excel dosyalarının manipülasyonu ustalaşmak için hayati önem taşır. Bu öğreticide, IronXL kullanarak Excel aralıklarıyla çalışma üzerine odaklanacağız. Bir Excel dosyasında yazmayı, okumayı ve aralıklarla işlem yapmayı nasıl gerçekleştireceğimizi inceleyeceğiz.

How to Read Excel Ranges in C#

1. Excel dosyalarını ele almak için IronXL kütüphanesini yükleyin.
2. Çalışma kitabını yükleyin ve çalışma sayfasını belirtin.
3. Okunacak hücre aralığını seçin.
4. Belirtilen aralıktan veri çıkarın ve okuyun.

IronXL Nedir?

IronXL, Excel dosyalarıyla çalışmayı basitleştiren, sorunsuz entegrasyon ve elektronik tablo verilerinin işlenmesi için bir dizi özellik sunan kapsamlı bir C# kütüphanesidir. Yetenekleri, Microsoft Excel kurulumunu gerektirmeyerek, platformlar arası uyumluluğu sağlayan Excel dosyalarını okuma, yazma ve düzenlemeyi içerir.

IronXL, belirli hücreler, aralıklar veya tüm çalışma sayfalarından veri çıkarma, yanı sıra formatlama, stil ve koşullu formatlama gibi gelişmiş işlevler kolaylaştırır. Hesaplamalar, formüller ve istatistiksel analizler desteği ile IronXL, geliştiricilere C# uygulamalarında veri merkezli görevleri otomatikleştirmek için etkili araçlar sunar.

Getting Started with Excel Range of cells in C#

Öncelikle, uygulamamızda IronXL Kütüphanesini yüklememiz gerekiyor.

IronXL NuGet Paketini Yüklemek

IronXL'i aşağıdaki komut ile NuGet Paket Yöneticisi aracılığıyla yükleyebilirsiniz:

Install-Package IronXL.Excel

Yukarıdaki komut, IronXL'i tüm bağımlılıkları ile yükler.

Namespace Ekle

Program.cs sınıfının en üstüne veya IronXL yöntemlerini kullanmak istediğiniz herhangi bir yere aşağıdaki namespace'i ekleyin.

using IronXL;

using IronXL;

Imports IronXL

Imports IronXL

Excel Çalışma Kitabını Yükle

İlk adım, Excel çalışma kitabını yüklemektir. Aşağıdaki kod, uygulamamızda Excel çalışma kitabını yükleyecektir.

static void Main(string[] args)
{
    // Load an existing Excel workbook
    var workbook = WorkBook.Load("test_excel.xlsx");
    
    // Retrieve the specified worksheet from the workbook
    var sheet = workbook.GetWorkSheet("Sheet1");
}

static void Main(string[] args)
{
    // Load an existing Excel workbook
    var workbook = WorkBook.Load("test_excel.xlsx");
    
    // Retrieve the specified worksheet from the workbook
    var sheet = workbook.GetWorkSheet("Sheet1");
}

Sub Main(args As String())
    ' Load an existing Excel workbook
    Dim workbook = WorkBook.Load("test_excel.xlsx")
    
    ' Retrieve the specified worksheet from the workbook
    Dim sheet = workbook.GetWorkSheet("Sheet1")
End Sub

Sub Main(args As String())
    ' Load an existing Excel workbook
    Dim workbook = WorkBook.Load("test_excel.xlsx")
    
    ' Retrieve the specified worksheet from the workbook
    Dim sheet = workbook.GetWorkSheet("Sheet1")
End Sub

"test_excel.xlsx" adlı dosyadan mevcut bir Excel çalışma kitabını yükleyen ilk satır. Yüklenen çalışma kitabından "Sheet1" adlı çalışma sayfasını getiren ikinci satır.

Bu eğitimin tamamında aşağıdaki Excel dosyasını kullanacağım.

Bir Aralıktan Veri Okuma

Şimdi, belirtilen hücre aralıklarından veri okuyalım.

// Define a range from cell A2 to G10 in the worksheet
var range = sheet["A2:G10"];

// Iterate over each cell in the range and output its value
foreach (var item in range)
{
    Console.WriteLine(item);
}

// Define a range from cell A2 to G10 in the worksheet
var range = sheet["A2:G10"];

// Iterate over each cell in the range and output its value
foreach (var item in range)
{
    Console.WriteLine(item);
}

' Define a range from cell A2 to G10 in the worksheet
Dim range = sheet("A2:G10")

' Iterate over each cell in the range and output its value
For Each item In range
	Console.WriteLine(item)
Next item

' Define a range from cell A2 to G10 in the worksheet
Dim range = sheet("A2:G10")

' Iterate over each cell in the range and output its value
For Each item In range
	Console.WriteLine(item)
Next item

İlk satır, çalışma sayfasında A2'den G10'a kadar olan belirli bir aralık adresini seçerek, aynı anda birden fazla Excel hücresi ile çalışmanıza olanak tanır. foreach (var item in range) döngüsü, bu hücre aralığında her bir hücreyi yineleyerek verimli veri işlemeye olanak tanır.

Console.WriteLine(item); kullanarak, kod her hücrenin değerini konsola yazdırır, böylece aralığın içeriğini gözden geçirmek kolaylaşır. Bu yaklaşım, veri işlemlerini basitleştirir ve kodun okunabilirliğini artırır.

Excel Formüllerini Aralıkta Kullanma

Belirli bir aralık seçip, bazı Excel formüllerini uygulayalım.

// Define a range from cell F2 to F42 for statistical analysis
var range = sheet["F2:F42"];

// Output the minimum age within the range
Console.WriteLine($"Minimum Age: {range.Min()}");

// Output the maximum age within the range
Console.WriteLine($"Maximum Age: {range.Max()}");

// Output the average age, casting the average value to an integer
Console.WriteLine($"Average Age: {(int)range.Avg()}");

// Define a range from cell F2 to F42 for statistical analysis
var range = sheet["F2:F42"];

// Output the minimum age within the range
Console.WriteLine($"Minimum Age: {range.Min()}");

// Output the maximum age within the range
Console.WriteLine($"Maximum Age: {range.Max()}");

// Output the average age, casting the average value to an integer
Console.WriteLine($"Average Age: {(int)range.Avg()}");

Imports System

' Define a range from cell F2 to F42 for statistical analysis
Dim range = sheet("F2:F42")

' Output the minimum age within the range
Console.WriteLine($"Minimum Age: {range.Min()}")

' Output the maximum age within the range
Console.WriteLine($"Maximum Age: {range.Max()}")

' Output the average age, casting the average value to an integer
Console.WriteLine($"Average Age: {CInt(Math.Truncate(range.Avg()))}")

Imports System

' Define a range from cell F2 to F42 for statistical analysis
Dim range = sheet("F2:F42")

' Output the minimum age within the range
Console.WriteLine($"Minimum Age: {range.Min()}")

' Output the maximum age within the range
Console.WriteLine($"Maximum Age: {range.Max()}")

' Output the average age, casting the average value to an integer
Console.WriteLine($"Average Age: {CInt(Math.Truncate(range.Avg()))}")

Kod var range = sheet["F2:F42"];, F2'den F42'ye kadar olan hücre aralığını seçer ve yaş verilerinin istatistiksel analizi için kolaylık sağlar. range.Min() ve range.Max() kullanarak, belirtilen aralıktaki minimum ve maksimum yaş değerlerini verimli bir şekilde hesaplar, demografik içgörüler elde etmeye yardımcı olur.

Ek olarak, range.Avg() ortalama yaşı hesaplar ve veri yorumu için değerli istatistiksel ölçümler sunar. Bu yaklaşım, veri analizi görevlerini basitleştirirken, hızlı erişim sağlayarak bilgiye dayalı kararlar almayı destekleyen temel istatistiksel bilgilere ulaşmanızı sağlar.

Tek Bir Hücreden Veri Okuma

Tek bir hücreden veri okuyalım.

// Retrieve the value from cell B2 in the worksheet
var read_from_single_cell = sheet["B2"];

// Output the value in cell B2
Console.WriteLine($"The Value in Cell B2 is: {read_from_single_cell}");

// Retrieve the value from cell B2 in the worksheet
var read_from_single_cell = sheet["B2"];

// Output the value in cell B2
Console.WriteLine($"The Value in Cell B2 is: {read_from_single_cell}");

' Retrieve the value from cell B2 in the worksheet
Dim read_from_single_cell = sheet("B2")

' Output the value in cell B2
Console.WriteLine($"The Value in Cell B2 is: {read_from_single_cell}")

' Retrieve the value from cell B2 in the worksheet
Dim read_from_single_cell = sheet("B2")

' Output the value in cell B2
Console.WriteLine($"The Value in Cell B2 is: {read_from_single_cell}")

Kod var read_from_single_cell = sheet["B2"];, B2 hücresinde saklanan değeri çalışma sayfasından alır. Bu yaklaşımla, Excel dosyasındaki belirli hücre değerlerine kolayca erişebilirsiniz.

Console.WriteLine($"The Value in Cell B2 is: {read_from_single_cell}"); ile kod, başvuru hücrelerinin alınan değerini konsola yazdırır, veri doğrulama ve hata ayıklamayı kolaylaştırır. Bu, Excel dosyalarından bireysel hücre değerlerini almayı ve görüntülemeyi basitleştirir.

Tüm Sütundan Veri Okuma

Index kullanarak tüm sütundan veri okuyalım.

// Retrieve values from the column at index 2 (C column) 
var columnValues = sheet.GetColumn(2); // 2 is column index

// Iterate over each value in the column and output it
foreach (var columnValue in columnValues)
{
    Console.WriteLine(columnValue);
}

// Retrieve values from the column at index 2 (C column) 
var columnValues = sheet.GetColumn(2); // 2 is column index

// Iterate over each value in the column and output it
foreach (var columnValue in columnValues)
{
    Console.WriteLine(columnValue);
}

' Retrieve values from the column at index 2 (C column) 
Dim columnValues = sheet.GetColumn(2) ' 2 is column index

' Iterate over each value in the column and output it
For Each columnValue In columnValues
	Console.WriteLine(columnValue)
Next columnValue

' Retrieve values from the column at index 2 (C column) 
Dim columnValues = sheet.GetColumn(2) ' 2 is column index

' Iterate over each value in the column and output it
For Each columnValue In columnValues
	Console.WriteLine(columnValue)
Next columnValue

Kod var columnValues = sheet.GetColumn(2);, çalışma sayfasındaki 2. indekste (C sütunu) yer alan sütundan tüm değerleri alır. Bu, Excel tablosunun belirli bir sütunundaki tüm değerlere verimli bir şekilde erişmenizi sağlar.

foreach döngüsü ile columnValues üzerinde yineleyerek, sütundaki her değer Console.WriteLine(columnValue); kullanılarak konsola yazdırılır. Bu yaklaşım, Excel dosyalarından sütun verilerini işleme ve görüntülemeyi kolaylaştırır, veri analizi görevlerini düzene sokar.

Alternatif olarak, bir sütunun adını kullanarak da veri okuyabiliriz. Aşağıdaki örneğe bakın:

// Retrieve values from the column with name "C"
var columnValues = sheet.GetColumn("C");

// Retrieve values from the column with name "C"
var columnValues = sheet.GetColumn("C");

' Retrieve values from the column with name "C"
Dim columnValues = sheet.GetColumn("C")

' Retrieve values from the column with name "C"
Dim columnValues = sheet.GetColumn("C")

Bu şekilde, birkaç sütunu belirleyebiliriz.

Tüm Satırdan Veri Okuma

Satır numaralarını kullanarak tüm satırdan veri okuyalım.

// Retrieve values from the row at index 1 (Row 2)
var rowValues = sheet.GetRow(1); // 1 is row index

// Iterate over each value in the row and output it
foreach (var rowValue in rowValues)
{
    Console.Write(rowValue + "  ");
}

// Retrieve values from the row at index 1 (Row 2)
var rowValues = sheet.GetRow(1); // 1 is row index

// Iterate over each value in the row and output it
foreach (var rowValue in rowValues)
{
    Console.Write(rowValue + "  ");
}

' Retrieve values from the row at index 1 (Row 2)
Dim rowValues = sheet.GetRow(1) ' 1 is row index

' Iterate over each value in the row and output it
For Each rowValue In rowValues
	Console.Write(rowValue & "  ")
Next rowValue

' Retrieve values from the row at index 1 (Row 2)
Dim rowValues = sheet.GetRow(1) ' 1 is row index

' Iterate over each value in the row and output it
For Each rowValue In rowValues
	Console.Write(rowValue & "  ")
Next rowValue

Kod var rowValues = sheet.GetRow(1);, çalışma sayfasındaki 1. indekste (Satır 2) yer alan tek bir satırdan tüm değerleri alır, satıra özgü verilere verimli erişim sağlar. foreach döngüsü ile rowValues üzerinde yineleyerek, satırdaki her değer Console.Write(rowValue + " "); kullanılarak konsola yazdırılır.

Bu yaklaşım, Excel dosyalarından satır verilerinin alınmasını ve görüntülenmesini basitleştirerek, veri analizi ve raporlama görevlerini destekler. Bu şekilde, aralık belirtmeden birden çok hücreden değerleri okuyabiliriz.

Hücre veya Aralığa Veri Yazma

Hem hücreye hem de aralığa veri yazabiliriz. Öncelikle, bir aralığa veri yazacağız.

// Select a range from D2 to D14 for modification
var range = sheet["D2:D14"];

// Set the value for each cell in the range
range.Value = "Prefer Not to Say"; // Change Gender Value

// Save the modified workbook to persist changes
workbook.Save();

// Select a range from D2 to D14 for modification
var range = sheet["D2:D14"];

// Set the value for each cell in the range
range.Value = "Prefer Not to Say"; // Change Gender Value

// Save the modified workbook to persist changes
workbook.Save();

' Select a range from D2 to D14 for modification
Dim range = sheet("D2:D14")

' Set the value for each cell in the range
range.Value = "Prefer Not to Say" ' Change Gender Value

' Save the modified workbook to persist changes
workbook.Save()

' Select a range from D2 to D14 for modification
Dim range = sheet("D2:D14")

' Set the value for each cell in the range
range.Value = "Prefer Not to Say" ' Change Gender Value

' Save the modified workbook to persist changes
workbook.Save()

Kod var range = sheet["D2:D14"];, D2'den D14'e kadar bir alan seçer ve toplu veri değişikliklerine olanak tanır. range.Value'i 'Tercih Etmemek' olarak ayarlayarak, belirtilen aralıktaki her hücre için cinsiyet değerini verimli bir şekilde günceller, tekrarlanan görevleri en aza indirir.

Ardından gelen workbook.Save(); komutu, bu değişikliklerin kalıcı saklanmasını sağlar ve veri tutarlılığı ve bütünlüğünü korur. Bu yaklaşım, toplu güncellemeleri basitleştirir ve birçok hücrede birlik sağlar, veri yönetim verimliliğini artırır.

Şimdi, belirli bir hücreye veri yazalım.

// Set the value for cell B2
sheet["B2"].Value = "John";

// Save the workbook to persist the changes
workbook.Save();

// Set the value for cell B2
sheet["B2"].Value = "John";

// Save the workbook to persist the changes
workbook.Save();

' Set the value for cell B2
sheet("B2").Value = "John"

' Save the workbook to persist the changes
workbook.Save()

' Set the value for cell B2
sheet("B2").Value = "John"

' Save the workbook to persist the changes
workbook.Save()

Kod sheet["B2"].Value = "John";, 'John' değerini doğrudan Excel çalışma sayfasındaki B2 hücresine atar, belirli hücre değerlerini güncellemek için özlü ve basit bir yöntem sunar. Bu yaklaşım, bireysel hücre içeriklerini değiştirmenin basitleştirilmesini, kodun okunabilirliğini ve verimliliğini artırır.

Sonuç

Sonuç olarak, IronXL kullanarak C#'ta Excel aralık işlemlerinde ustalaşmak, uygulamaların verimliliğini ve otomasyon yeteneklerini önemli ölçüde artırır, veri işlemesi, rapor oluşturma ve dinamik elektronik tablo oluşturma gibi görevleri kolaylaştırır.

IronXL'nin Excel dosyalarını okuma, yazma ve manipüle etme konusundaki güçlü özellikleriyle, geliştiriciler veri işlemlerini düzenleyebilir ve formüller, formatlama ve istatistiksel analizler gibi gelişmiş işlevleri kullanabilir. Ayrıca, IronXL ücretsiz bir deneme sunar, çeşitli proje gereksinimleri için esneklik ve ölçeklenebilirliği garanti eder.