C# ile Yeni Satır ve Sütun Ekleme Nasıl Yapılır

Updated: 29 Haziran 2026

IronXL kütüphanesi, Office Interop kullanmadan C# kodunda tek veya birden fazla satır ve sütun eklemenin uygun bir yolunu sunar. Excel elektronik tablolarını programatik olarak dinamik bir şekilde değiştirmek için InsertRows ve InsertColumns yöntemlerini herhangi bir indeks konumunda kullanın.

Hızlı Başlangıç: IronXL ile Zahmetsizce Satır veya Sütun Ekleyin

IronXL, tek bir akıcı API çağrısı ile herhangi bir konumda satır veya sütun eklemenize olanak tanır. Minimal kod kullanarak Excel sayfalarını verimli bir şekilde değiştirin.

1Install IronXL with NuGet Package Manager
PM > Install-Package IronXL.Excel
```
Install-Package IronXL.Excel
```

2Bu kod parçacığını kopyalayın ve çalıştırın.

new WorkBook("example.xlsx").DefaultWorkSheet.InsertColumns(3, 2);

new WorkBook("example.xlsx").DefaultWorkSheet.InsertColumns(3, 2);

3Canlı ortamınızda test için dağıtım yapın

Ücretsiz deneme ile bugün projenizde IronXL kullanmaya başlayın

Asgari İş Akışı (5 adım)

IronXL kütüphanesini ve kurulum komutunu kullanarak C# ile Excel satır ve sütunları eklemek için 5 adımlı süreç

Excel'de yeni satır ve sütun eklemek için C# kütüphanesini indirin
Yeni satırlar eklemek için InsertRow ve InsertRows yöntemlerini kullanın
Yeni sütunlar eklemek için InsertColumn ve InsertColumns yöntemlerini kullanın
Yeni eklenen satır ve sütunlara veri ekleyin
Düzenlenen Excel dosyasını çeşitli dosya türlerine dışa aktarın

C# Kullanarak Excel'e Yeni Satırları Nasıl Eklerim?

Elektronik tabloya yeni satırlar eklemek için InsertRow ve InsertRows yöntemlerini kullanın. Bu yöntemler, belirli bir dizin konumunun satırlarını eklemenizi sağlar. IronXL API Referansı, tüm mevcut satır manipülasyon yöntemleri için kapsamlı dokümantasyon sağlar.

Lütfen dikkate alın: Filtre satırına doğrudan satır eklemek, Excel dosyasında çakışmalara neden olabilir, elektronik tabloyu düzgün şekilde görebilmeniz için Excel onarımını çalıştırmanız gerektiğini gerektirir.

Tek Satır Eklemek için Sözdizimi Nedir?

using IronXL;

// Load existing spreadsheet
WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Add a row before row 2
workSheet.InsertRow(1);

// Insert multiple rows after row 3
workSheet.InsertRows(3, 3);

workBook.SaveAs("addRow.xlsx");

using IronXL;

// Load existing spreadsheet
WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Add a row before row 2
workSheet.InsertRow(1);

// Insert multiple rows after row 3
workSheet.InsertRows(3, 3);

workBook.SaveAs("addRow.xlsx");

Imports IronXL

' Load existing spreadsheet
Private workBook As WorkBook = WorkBook.Load("sample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Add a row before row 2
workSheet.InsertRow(1)

' Insert multiple rows after row 3
workSheet.InsertRows(3, 3)

workBook.SaveAs("addRow.xlsx")

Imports IronXL

' Load existing spreadsheet
Private workBook As WorkBook = WorkBook.Load("sample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Add a row before row 2
workSheet.InsertRow(1)

' Insert multiple rows after row 3
workSheet.InsertRows(3, 3)

workBook.SaveAs("addRow.xlsx")

InsertRow yöntemi, yeni satırın eklenmesi gereken sıfır tabanlı indeksi belirten tek bir parametre alır. O konumdaki ve altındaki tüm mevcut satırlar otomatik olarak aşağıya kayar. Veri ile çalışmayı içeren daha karmaşık senaryolar için, satır ekleme işlemini formüller ve hesaplamalarla birleştirebilir.

Çoklu Satır Eklemeleri Nasıl Çalışır?

Çalışan veri tablosunun pozisyon 2'de yeni satır eklenmiş önce ve sonra hesap tablosu görünümleri

InsertRows kullanılırken, hem başlangıç indeksini hem de eklenmesi gereken satır sayısını belirtin. Bu yöntem, veri şablonlarını hazırlarken veya veri setlerini dinamik olarak genişletirken paha biçilmezdir. Yöntem, tüm mevcut biçimlendirme ve formülleri korur, hücre referanslarını otomatik olarak ayarlar.

Satır Eklerken Ortak Tuzaklar Nelerdir?

Programatik olarak satır eklerken birkaç zorluk ortaya çıkabilir:

Indeks Karışıklığı: IronXL, sıfır tabanlı indeksleme kullanır, bu nedenle Excel'deki satır 1, kodda indeks 0'a karşılık gelir.
Tablo Sınırları: Adlandırılmış tablolar içinde satır eklerken özel dikkat gereklidir - adlandırılmış tablolar konusundaki kılavuzumuza bakın.
Performans Etkisi: Çok sayıda satır eklerken, performansı artırmak için toplu işlemleri göz önünde bulundurun, bunlar performans kilometre taşları sayfasında detaylandırılmıştır.
Formül Güncellemeleri: Formüllerdeki hücre referansları otomatik olarak güncellenir, ancak mutlak referanslar sabit kalır

Dizin Pozisyonu Neden Önemlidir?

Dizin pozisyonu, yeni satırınızın nerede görüneceğini ve mevcut verilerin nasıl kaydırılacağını belirler. Yanlış dizinler kullanmak, verilerin üzerine yazabilir veya elektronik tablonuzda boşluklar oluşturabilir. Aralık seçimi kılavuzumuzu gözden geçirin daha iyi pozisyon anlaşılıp yapılması/devamı için karmaşık veri manipülasyon senaryoları için gözden geçirin.

InsertRow``InsertRows

Bir Excel Sayfasından Satırları Nasıl Kaldırabilirim?

Elektronik tablodan bir satırı kaldırmak için, istenen satırı seçmek için GetRow yöntemini kullanın ve ardından seçilen satırda RemoveRow yöntemini kullanın. Bu iki aşamalı süreç, hangi verinin kaldırılacağı üzerinde kesin kontrol sağlar.

Lütfen dikkate alın: Tablonun başlık satırı kaldırılamaz.

Temel Kaldırma Sözdizimi Nedir?

using IronXL;

// Load existing spreadsheet
WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Remove row 5
workSheet.GetRow(4).RemoveRow();

workBook.SaveAs("removeRow.xlsx");

using IronXL;

// Load existing spreadsheet
WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Remove row 5
workSheet.GetRow(4).RemoveRow();

workBook.SaveAs("removeRow.xlsx");

Imports IronXL

' Load existing spreadsheet
Private workBook As WorkBook = WorkBook.Load("sample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Remove row 5
workSheet.GetRow(4).RemoveRow()

workBook.SaveAs("removeRow.xlsx")

Imports IronXL

' Load existing spreadsheet
Private workBook As WorkBook = WorkBook.Load("sample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Remove row 5
workSheet.GetRow(4).RemoveRow()

workBook.SaveAs("removeRow.xlsx")

Satırları Programatik Olarak Ne Zaman Kaldırmalıyım?

Satır kaldırma birkaç senaryoda önemli hale gelir:

Veri Temizliği: İçeri aktarılan veri kümelerinden boş veya geçersiz satırları kaldırın.
Dinamik Filtreleme: Belirli kriterleri karşılamayan satırları silin.
Şablon Hazırlama: Raporlar oluşturulmadan önce örnek verileri temizleyin.
Performans Optimizasyonu: Gereksiz satırları kaldırarak dosya boyutunu küçültün.

Daha karmaşık veri manipülasyonu için, [Excel dosyalarını düzenleme](https://ironsoftware.com/csharp excels how-to/csharp-edit-excel-file/) konumuzu keşfedin; bu kapsamlı düzenleme tekniklerini ele alır.

Kaldırılan Satırların Altındaki Verilere Ne Olur?

Çalışan veri tablosundan E02035 Liliana Chang çalışan satırının kaldırılması öncesi ve sonrasını karşılaştıran hesap tablosu görüntüleri

Bir satırı sildiğinizde, altındaki tüm satırlar otomatik olarak boşluğu doldurmak için yukarı kayar. Bu, manuel müdahale olmadan veri bütünlüğünü korur. Kaldırılan satırı referans gösteren formüller hatalar verebilir, bu nedenle bağımlı hesaplamaları güncellemeyi düşünün. Formül güncellemeyi nasıl işleyebileceğiniz için formülleri düzenleme kılavuzumuza bakın.

Excel Elektronik Tablolarına Yeni Sütunları Nasıl Eklerim?

Tablodaki belirli bir indeks konumundan önce yeni sütunlar eklemek için InsertColumn ve InsertColumns yöntemlerini kullanın. Bu yöntemler satır ekleme işlevinize ayna tutar ama yatay eksende çalışır.

Lütfen dikkate alın: Tablo alanı içinde yeni sütunlar eklemek, Excel dosyasında çakışmalara sebep olabilir, bu durumda elektronik tabloyu düzgün görebilmeniz için Excel onarımı çalıştırmanız gerekir. Aralık sınırlarında tüm boş satırları ve sütunları kaldırmak için Trim() metodunu kullanın. Şu anda, sütunları kaldırmak mümkün değildir.

Uyarı: Tamamen boş bir sayfaya yeni bir sütun eklemeye çalışmak, 'Sıra hiçbir öğe içermiyor' mesajıyla System.InvalidOperationException ile sonuçlanacaktır.

Tek ve Çoklu Sütun Eklemeyi Hangi Kod Yapar?

using IronXL;

// Load existing spreadsheet
WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Add a column before column A
workSheet.InsertColumn(0);

// Insert multiple columns after column B
workSheet.InsertColumns(2, 2);

workBook.SaveAs("addColumn.xlsx");

using IronXL;

// Load existing spreadsheet
WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Add a column before column A
workSheet.InsertColumn(0);

// Insert multiple columns after column B
workSheet.InsertColumns(2, 2);

workBook.SaveAs("addColumn.xlsx");

Imports IronXL

' Load existing spreadsheet
Private workBook As WorkBook = WorkBook.Load("sample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Add a column before column A
workSheet.InsertColumn(0)

' Insert multiple columns after column B
workSheet.InsertColumns(2, 2)

workBook.SaveAs("addColumn.xlsx")

Imports IronXL

' Load existing spreadsheet
Private workBook As WorkBook = WorkBook.Load("sample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Add a column before column A
workSheet.InsertColumn(0)

' Insert multiple columns after column B
workSheet.InsertColumns(2, 2)

workBook.SaveAs("addColumn.xlsx")

Sütun Dizinleme Nasıl Çalışır?

Sütun dizinleme, satırlarla aynı sıfır tabanlı modeli takip eder:

Sütun A = indeks 0
Sütun B = indeks 1
Sütun C = indeks 2

Bu tutarlılık, elektronik tablonuzun iki boyutu üzerinde çalışmayı basitleştirir. Hücre veri biçimlendirme ile birleştirildiğinde, uygun biçimlendirilmiş veri tablolarını programatik olarak oluşturabilirsiniz.

Sütun İşlemlerinin Sınırlamaları Nelerdir?

Çalışan Kimliği ve Tam Ad sütunları arasına yeni boş bir sütunun eklenmesini gösteren Excel öncesi/sonrası karşılaştırması

Mevcut sınırlamalar şunları içerir:

Doğrudan Sütun Kaldırma Yok: Satırların aksine, sütunlar doğrudan kaldırılamaz (geçici çözüm: gerekli verileri yeni bir sayfaya kopyalayın)
Tablo Kısıtlamaları: Adli tablolar içinde sütunlar özel işleme gerektirir
Maksimum Sütun Sınırı: Excel, 16.384 sütuna (XFD) kadar destekler
Performans Göz Önünde Bulundurma: Büyük sütun eklemeleri dosya boyutunu önemli ölçüde etkileyebilir

Bu sınırlamaların üstesinden gelmek için, dosya boyutu sınırları kılavuzumuz, optimizasyon stratejileri sağlar.

İpuçları: Tüm satır ve sütun indeks pozisyonları sıfır tabanlı dizinlemedir.

Satır ve Sütun İşlemleri için En İyi Uygulamalar

Excel yapısını programatik olarak değiştirirken:

Her Zaman Endeksleri Doğrulayın: İşlem yapmadan önce hedef indeksinizin mevcut olduğundan emin olun
Toplu İşlemler: Daha iyi performans için birden fazla ekleme işlemini gruplayın
Formatı Korumak: Biçimlendirilmiş satır/sütun eklerken stil kopyalamasını kullanın
Kenarlık Durumlarını Test Edin: Sayfa sınırlarında (satır 1, sütun A) davranışı doğrulayın
Hataları Yönetin: Geçersiz işlemler için uygun hata işlemeyi uygulayın

Excel otomasyon işlemleri için kapsamlı bilgiler edinmek adına, bu ilkeleri uygulamalı olarak gösteren Excel dosyası oluşturma konulu eğitimimizi inceleyin.

Sıkça Sorulan Sorular

Excel'de C# kullanarak nasıl yeni satırlar ekleyebilirim?

IronXL'nin InsertRow ve InsertRows yöntemlerini kullanarak Excel elektronik tablolarına yeni satırlar ekleyin. InsertRow yöntemi, belirli bir sıfır tabanlı dizin konumuna tek bir satır eklerken, InsertRows bir kerede birden fazla satır eklemenize olanak tanır. IronXL, mevcut satırları otomatik olarak aşağı kaydırır ve biçimlendirme ve formülleri korur.

Programlı olarak bir Excel dosyasına sütun ekleme söz dizimi nedir?

IronXL, Excel dosyalarına sütun eklemek için InsertColumn ve InsertColumns yöntemlerini sağlar. Satır ekleme ile benzer şekilde, sütunların ekleneceği dizin konumunu belirtiyorsunuz. Örneğin, InsertColumns(3, 2) iki sütunu dizin konumu 3'ten başlayarak ekler.

Microsoft Office yüklü olmadan satır ve sütun ekleyebilir miyim?

Evet, IronXL, Excel dosyalarına satır ve sütun eklemenize olanak tanır ve bu işlem için Microsoft Office veya Office Interop gerektirmez. Bu bağımsız bir C# kütüphanesidir ve Excel dosya formatları ile direkt çalışarak server ortamları ya da Office kurulumuna sahip olmayan sistemler için idealdir.

Yeni satır veya sütun eklerken mevcut verilerin durumu ne olur?

IronXL'nin ekleme yöntemlerini kullanırken, mevcut veriler yeni satırlar veya sütunlar için otomatik olarak kaydırılır. Satır eklerken satırlar aşağıya, sütun eklerken sütunlar sağa kaydırılır. Tüm biçimlendirme, formüller ve hücre referansları otomatik olarak ayarlanır.

Yeni eklenen satır ve sütunlara nasıl veri eklerim?

IronXL ile satır veya sütun ekledikten sonra, bunları standart hücre atama yöntemleriyle doldurabilirsiniz. Kütüphane, koordinatlarına göre hücrelere erişim için akıcı bir API sağlar ve yeni oluşturulan alana değerler, formüller ve biçimlendirme ayarlamanızı sağlar.

Programlı olarak satır eklerken yaygın sorunlar nelerdir?

Yaygın zorluklar, sıfır tabanlı dizin karışıklığı (Excel satırı 1 = IronXL'de dizin 0), filtre satırları üzerinde ekleme yaparken oluşan çakışmalar ve büyük parti işlemler için performans göz önünde bulundurulmasıdır. IronXL'nin belgeleri, adlandırılmış tablolarla nasıl başa çıkılacağı ve toplu eklemeler için performansın nasıl optimize edileceği konusunda rehberlik sağlar.

Can IronXL insert columns into a completely empty Excel sheet?

Attempting to insert a column into a completely empty sheet will result in a `System.InvalidOperationException`, as IronXL requires a pre-existing data structure to perform insertions.

What best practices should I follow when using IronXL to modify Excel structure?

Best practices include validating indices, using batch operations for performance, preserving formatting, testing edge cases, and implementing appropriate error handling.

What are the limitations of inserting columns within named tables using IronXL?

Inserting columns within named tables may require special handling to maintain table integrity, as column insertions can affect table structure and existing data mappings.

How can I optimize performance when adding multiple rows or columns with IronXL?

To optimize performance, use batch operations to group multiple insertions, and refer to IronXL's performance milestones documentation for strategies on improving process efficiency.

Curtis Chau

Mühendislik ekibiyle şimdi sohbet edin

Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

...

Daha Fazla Oku