Bugünün veri odaklı dünyasında, Microsoft Excel hem işletmeler hem de profesyoneller için vazgeçilmez bir araç olmaya devam etmektedir. İster sayıları analiz etmek, raporlar oluşturmak, isterse verileri görselleştirmek olsun, Excel'in çok yönlülüğü eşsizdir. Ancak, C# ile programlı olarak Excel dosyalarını manipüle etme söz konusu olduğunda, geliştiriciler genellikle zorluklarla karşılaşır. Bu, C# ortamında Excel otomasyonu için sorunsuz bir çözüm sunan IronXL kütüphanesinin devreye girdiği yerdir.

IronXL kütüphanesi, Iron Software tarafından hem C# .NET hem de VB.NET ortamlarda Excel belgelerini sorunsuz bir şekilde işlemek için sezgisel API'ler sunar. IronXL ile Microsoft Office veya Excel Interop bileşenlerini yükleme gerekliliği yoktur. Bu, geliştiricilerin Excel elektronik tablo dosyalarını zahmetsizce okumasına, düzenlemesine ve oluşturmasına olanak tanır; .NET 8, 7, 6, Core Çerçeveleri ve Azure ortamları dahil olmak üzere çeşitli .NET çerçevelerini tam olarak destekler.

Bu makalede, C# ve IronXL kullanarak Excel'de sütun genişliği ve yüksekliğinin otomatik ayarlanmasını öğreneceğiz.

1. Excel çalışma sayfasında Hücreleri Otomatik Sığdırmayı Demo Etmek için bir Visual Studio Projesi Oluşturun.
2. IronXL kütüphanesini projeye yükleyin.
3. IronXL kütüphanesi ile sütun genişliğini otomatik ayarlama.
4. IronXL kütüphanesi kullanarak Satır yüksekliğini otomatik ayarlama.
5. Sütun genişliğini ve Satır yüksekliğini IronXL kütüphanesini kullanarak Manuel olarak ayarlayın.

IronXL

IronXL kütüphanesi, C# geliştiricileri için Excel elektronik tablo işlemlerini basitleştirmek amacıyla tasarlanmış çok yönlü bir .NET kütüphanesidir. Hızlı ve sezgisel bir API sunan IronXL, kullanıcıların Office Interop'a bağlı kalmadan Excel dosyalarına kolayca erişmelerini, bunları değiştirmelerini ve oluşturmalarını sağlar. .NET Core ve Azure dahil olmak üzere çeşitli .NET framework'leriyle uyumluluğu, herhangi bir özel bağımlılık veya Microsoft Office kurulumu gerektirmeden genişletir. C#, VB.NET ve F# gibi birden çok .NET dilini destekleyen IronXL, konsol, web ve masaüstü uygulamaları dahil olmak üzere çok çeşitli geliştirme senaryolarına hitap eder. Üstelik, IronXL'nin uyumluluğu, Windows, Linux, macOS, Docker, Azure ve AWS dahil olmak üzere farklı platformlara yayılır ve bu da onu, çeşitli ortamlarda verimli Excel entegrasyonu arayan geliştiriciler için vazgeçilmez bir araç haline getirir.

IronXL kütüphanesinin Temel Özellikleri

1. Kolay Entegrasyon: IronXL, C# uygulamaları ile sorunsuz bir şekilde entegre olur ve Excel otomasyonu için basit ve sezgisel bir API sağlar. Geliştiriciler, minimal bir öğrenme eğrisiyle hızlıca başlayabilir.
2. Excel Dosyalarını Oku ve Yaz: IronXL ile mevcut Excel dosyalarından verileri kolayca okuyabilir ve yeni veya mevcut elektronik tablolara veri yazabilirsiniz. Bu yetenek, veri içe/dışa aktarma ve rapor oluşturma gibi görevler için gereklidir.
3. Biçimlendirme ve Stil: IronXL, fontlar, renkler, kenarlıklar ve daha fazlasını içeren Excel hücrelerine biçimlendirme ve stil uygulamanıza olanak tanır. Bu, oluşturulan Excel dosyalarınızın profesyonel ve düzgün bir görünüme sahip olmasını sağlar.
4. Formül Desteği: Karmaşık hesaplamalar yapmak veya Excel verilerine formüller uygulamak mı gerekiyor? IronXL, Excel formülleri desteği ile otomatik hesaplamalar ve veri manipülasyonlarını yapmanızı sağlar.
5. Otomatik Hücre Sığdırma: IronXL tarafından sunulan kullanışlı özelliklerden biri, Excel'deki hücreleri otomatik olarak sığdırma yeteneğidir, bu sayede içerik her hücreye düzgün bir şekilde sığar ve kesilmez.

Adım 1: Excel çalışma sayfasındaki hücrelerin otomatik sığdırmasını göstermek için bir Visual Studio Projesi oluşturun.

Başlamak için aşağıda gösterildiği gibi bir Visual Studio projesi oluşturalım. Listeden Console uygulaması şablonunu seçin

Bir proje adı ve konumu belirtin

Gerekli .NET sürümünü açılır menüden seçin ve oluştur düğmesine tıklayın

Adım 2: IronXL kütüphanesini projeye yükleyin.

Visual Studio NuGet Paket Yöneticisi'nden IronXL kütüphanesini yükleyin

Paket, NuGet Komut satırı kullanılarak da yüklenebilir

dotnet add package IronXL.Excel --version 2024.3.20

Bununla birlikte, kodlamaya başlamaya hazırız.

Adım 3: IronXL kütüphanesi ile Sütun Genişliğini Otomatik Sığdırma

IronXL kütüphanesinden AutoSizeColumn metodu, bir sütunun genişliğini içeriğine uygun şekilde ayarlar. Bu yöntem, hücrede kullanılan yazı tipine göre metin genişliğini hesaplar. Eğer sistemde tam olarak aynı font mevcut değilse, varsayılan bir font kullanarak ölçmeye çalışacaktır. Eğer varsayılan bir yazı tipi bulunamazsa, mevcut olan herhangi bir yazı tipini kullanmaya çalışacaktır. Ancak, hiçbir yazı tipi bulunmazsa bir istisna fırlatılacaktır. Bir parametre olarak sıfır tabanlı sütun indeksini kullanır. 0 ve (ColumnCount - 1) tarafından tanımlanan sınırlar içinde olmalıdır. Sağlanan columnIndex geçerli aralığın dışındaysa ArgumentException fırlatılır. Makinede hiçbir yazı tipi yüklü değilse SixLabors.Fonts.FontException fırlatılır.

Şimdi, bunu kullanarak bir Excel dosyasını nasıl yeniden boyutlandırabileceğimizi görelim. Örnek bir Excel dosyasını buradan indirebilirsiniz.

Girdi Dosyası

Burada sütun genişliklerinin düzgün tanımlanmadığını ve bu nedenle okunmasının çok zor olduğunu görebilirsiniz. Şimdi haydi IronXL kütüphanesini kullanarak bir Excel sayfasında sütun genişliklerini Otomatik Sığdırmayı nasıl yapabileceğimizi görün.

using IronXL;
// Load example spreadsheet
WorkBook workBook = WorkBook.Load("FinancialSample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
var colCount = workSheet.Columns.Count();

for (int i = 0; i < colCount; i++)
{ 
    // Auto-fit column width for index i
    workSheet.AutoSizeColumn(i);
}

// Save the autofitted workbook as a new file
workBook.SaveAs("autoResize.xlsx"); // Result file

using IronXL;
// Load example spreadsheet
WorkBook workBook = WorkBook.Load("FinancialSample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
var colCount = workSheet.Columns.Count();

for (int i = 0; i < colCount; i++)
{ 
    // Auto-fit column width for index i
    workSheet.AutoSizeColumn(i);
}

// Save the autofitted workbook as a new file
workBook.SaveAs("autoResize.xlsx"); // Result file

Imports IronXL
' Load example spreadsheet
Private workBook As WorkBook = WorkBook.Load("FinancialSample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
Private colCount = workSheet.Columns.Count()

For i As Integer = 0 To colCount - 1
	' Auto-fit column width for index i
	workSheet.AutoSizeColumn(i)
Next i

' Save the autofitted workbook as a new file
workBook.SaveAs("autoResize.xlsx") ' Result file

Imports IronXL
' Load example spreadsheet
Private workBook As WorkBook = WorkBook.Load("FinancialSample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
Private colCount = workSheet.Columns.Count()

For i As Integer = 0 To colCount - 1
	' Auto-fit column width for index i
	workSheet.AutoSizeColumn(i)
Next i

' Save the autofitted workbook as a new file
workBook.SaveAs("autoResize.xlsx") ' Result file

Kod Açıklaması

1. İlk olarak, WorkBook.Load() metodunu kullanarak FinancialSample.xlsx'i yüklüyoruz.
2. Ardından, ayarlamalar için sütun sayısını alırız.
3. Tüm sütun indekslerinde gezinerek sütun genişliklerini otomatik boyutlandırırız.
4. Son olarak, sonuçları autoResize.xlsx adlı yeni bir dosyaya kaydediyoruz.

Çıktı Dosyası

Aşağıda, tüm sütunların otomatik boyutlandığını ve görünür olduğunu görebilirsiniz.

Adım 4: IronXL kütüphanesi kullanarak Satır yüksekliğini otomatik ayarlama

AutoSizeRow metodu, bir satırın yüksekliğini içeriğine uygun şekilde ayarlar. Bu metodun, hücrede kullanılan yazı tipine dayalı olarak metin yüksekliğini hesapladığını belirtmek önemlidir. Eğer sistemde tam olarak aynı font mevcut değilse, varsayılan bir font kullanarak ölçmeye çalışacaktır. Eğer varsayılan bir yazı tipi bulunamazsa, mevcut olan herhangi bir yazı tipini kullanmaya çalışacaktır. Ancak, hiçbir yazı tipi bulunmazsa bir istisna fırlatılacaktır. Bir parametre olarak sıfır tabanlı satır indeksi kullanır. 0 ve (RowCount - 1) ile tanımlanan sınırlar içinde olmalıdır. Sağlanan rowIndex geçerli aralığın dışındaysa ArgumentException fırlatılır. Makinede hiçbir yazı tipi yüklü değilse SixLabors.Fonts.FontException fırlatılır.

Giriş Excel Dosyası

Aşağıdaki örnekte, bazı satırların verileri düzgün bir şekilde yerleştirecek şekilde boyutlandırılmadığını görebilirsiniz. Şimdi, Excel satır yüksekliklerini otomatik ayarlamak için C# koduna bakalım.

using IronXL;
// Load example spreadsheet
WorkBook workBook = WorkBook.Load("FinancialSample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
var rowCount = workSheet.RowCount;

for (int i = 0; i < rowCount; i++)
{
    // Auto-fit row height for index i
    workSheet.AutoSizeRow(i);
}

// Save the autofitted workbook as a new file
workBook.SaveAs("autoResizeRows.xlsx"); // Result file

using IronXL;
// Load example spreadsheet
WorkBook workBook = WorkBook.Load("FinancialSample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
var rowCount = workSheet.RowCount;

for (int i = 0; i < rowCount; i++)
{
    // Auto-fit row height for index i
    workSheet.AutoSizeRow(i);
}

// Save the autofitted workbook as a new file
workBook.SaveAs("autoResizeRows.xlsx"); // Result file

Imports IronXL
' Load example spreadsheet
Private workBook As WorkBook = WorkBook.Load("FinancialSample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
Private rowCount = workSheet.RowCount

For i As Integer = 0 To rowCount - 1
	' Auto-fit row height for index i
	workSheet.AutoSizeRow(i)
Next i

' Save the autofitted workbook as a new file
workBook.SaveAs("autoResizeRows.xlsx") ' Result file

Imports IronXL
' Load example spreadsheet
Private workBook As WorkBook = WorkBook.Load("FinancialSample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
Private rowCount = workSheet.RowCount

For i As Integer = 0 To rowCount - 1
	' Auto-fit row height for index i
	workSheet.AutoSizeRow(i)
Next i

' Save the autofitted workbook as a new file
workBook.SaveAs("autoResizeRows.xlsx") ' Result file

Kod Açıklaması

1. İlk olarak, WorkBook.Load() metodunu kullanarak FinancialSample.xlsx'i yüklüyoruz.
2. Toplam satır sayısını alıyoruz.
3. Tüm satır indekslerinde gezerek satır yüksekliklerini otomatik ayarlıyoruz.
4. Son olarak, sonuçları autoResizeRows.xlsx adlı yeni bir dosyaya kaydediyoruz.

Çıktı Excel Dosyası

Adım 5: IronXL kullanarak Sütun genişliği ve Satır yüksekliğini Manuel olarak Ayarlama

Satır ve sütunları otomatik boyutlandırmanın yanında, IronXL belirli bir satır yüksekliği değeri ve sütun genişliği değeri için genişlik ve yüksekliğini manuel olarak ayarlama seçeneği de sunmaktadır.

Giriş Excel Dosyası

using IronXL;
// Load example spreadsheet
WorkBook workBook = WorkBook.Load("FinancialSample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Manually set row height and column width
RangeRow row = workSheet.GetRow(0);
row.Height = 500; // Set height
RangeColumn col = workSheet.GetColumn(0);
col.Width = 5000; // Set width

// Save the workbook with specific values set
workBook.SaveAs("specificValue.xlsx");

using IronXL;
// Load example spreadsheet
WorkBook workBook = WorkBook.Load("FinancialSample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Manually set row height and column width
RangeRow row = workSheet.GetRow(0);
row.Height = 500; // Set height
RangeColumn col = workSheet.GetColumn(0);
col.Width = 5000; // Set width

// Save the workbook with specific values set
workBook.SaveAs("specificValue.xlsx");

Imports IronXL
' Load example spreadsheet
Private workBook As WorkBook = WorkBook.Load("FinancialSample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Manually set row height and column width
Private row As RangeRow = workSheet.GetRow(0)
row.Height = 500 ' Set height
Dim col As RangeColumn = workSheet.GetColumn(0)
col.Width = 5000 ' Set width

' Save the workbook with specific values set
workBook.SaveAs("specificValue.xlsx")

Imports IronXL
' Load example spreadsheet
Private workBook As WorkBook = WorkBook.Load("FinancialSample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Manually set row height and column width
Private row As RangeRow = workSheet.GetRow(0)
row.Height = 500 ' Set height
Dim col As RangeColumn = workSheet.GetColumn(0)
col.Width = 5000 ' Set width

' Save the workbook with specific values set
workBook.SaveAs("specificValue.xlsx")

Kod Açıklaması

1. WorkBook.Load() fonksiyonunu kullanarak FinancialSample.xlsx'i yükleyin.
2. Yüksekliğini ve genişliğini manuel olarak ayarlamak için belirli satırları ve sütunları alın.
3. İstenen yükseklik ve genişlik değerlerini ayarlayın.
4. Değiştirilmiş dosyayı specificValue.xlsx adıyla kaydedin.

Çıktı Excel Dosyası

Lisanslama

Free trial alarak IronXL'in tüm özelliklerini 30 gün ücretsiz kullanabilirsiniz.

Alınan lisansın appSettings.json dosyasına yerleştirilmesi gerekir:

{
  "IronXL.License.LicenseKey": "myTrialKey"
}

{
  "IronXL.License.LicenseKey": "myTrialKey"
}

Sonuç

IronXL tarafından sağlanan AutoSizeColumn ve AutoSizeRow gibi özelliklerle, geliştiriciler, Excel elektronik tablolarının ithal edilen veriler, dinamik raporlar, kullanıcı tarafından oluşturulan içerik veya veri analiz sonuçları gibi içeriklere dinamik olarak uyum sağladığını kolayca garantileyebilir.

IronXL'in .NET Core ve Azure dahil olmak üzere çeşitli .NET framework'leriyle uyumluluğu, geliştiricilerin Microsoft Office veya Excel Interop'a bağımlı olmadan Excel otomasyonunu geniş bir uygulama yelpazesine dahil etmelerini sağlar. Ayrıca, IronXL'in birden fazla .NET dili ve platformunu desteklemesi, Excel manipülasyon görevlerini farklı ortamlarda yaymak isteyen geliştiriciler için çok yönlü bir seçenek haline getirir.

Özetle, IronXL, günümüz C# geliştirme taleplerine uygun kapsamlı bir özellik paketi sunarak Excel otomasyon projelerinde verimlilik, doğruluk ve esnekliği artırmak için geliştiricilere güç verir. İster rapor üretmek, ister veri analiz etmek veya bilgileri sunmak olsun, IronXL, C# ekosisteminde Excel otomasyonunda mükemmel olmak için gerekli araçları sağlar.