Bir C# Geliştiricisi Olarak Excel'de Satır ve Sütun Ekleme

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

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronXL kütüphanesi, Office Interop kullanmadan C# koduna tek veya birden fazla satır ve sütun eklemek için kullanışlı bir yol sunar. Excel elektronik tablolarını programlı olarak dinamik olarak değiştirmek için herhangi bir dizin konumunda InsertRows ve InsertColumns yöntemlerini 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.

  1. IronXL aşağıdaki NuGet Paket Yöneticisi ile yükleyin

    PM > Install-Package IronXL.Excel
  2. Bu kod parçacığını kopyalayın ve çalıştırın.

    new WorkBook("example.xlsx").DefaultWorkSheet.InsertColumns(3, 2);
  3. Canlı ortamınızda test için dağıtım yapın

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

    arrow pointer


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

Hesap tablosuna 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ınFiltre 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?

:path=/static-assets/excel/content-code-examples/how-to/add-rows-columns-rows.cs
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")
$vbLabelText   $csharpLabel

InsertRow yöntemi, yeni satırın ekleneceği sıfır tabanlı indeksi belirten tek bir parametre kabul eder. 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ırken, hem başlangıç indeksini hem de eklenecek 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:

  1. 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.
  2. 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.
  3. 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.
  4. 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?

Hesap tablosundan bir satırı silmek için, GetRow yöntemini kullanarak istediğiniz satırı seçin 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ınTablonun başlık satırı kaldırılamaz.

Temel Kaldırma Sözdizimi Nedir?

:path=/static-assets/excel/content-code-examples/how-to/add-rows-columns-remove-row.cs
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")
$vbLabelText   $csharpLabel

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 dizin konumunun önüne 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ınTablo 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. To remove all empty rows and columns on the range borders, use the Trim() method. Ş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 birlikte System.InvalidOperationException hatasına neden olacaktır.

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

:path=/static-assets/excel/content-code-examples/how-to/add-rows-columns-columns.cs
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")
$vbLabelText   $csharpLabel

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:

  1. Her Zaman Endeksleri Doğrulayın: İşlem yapmadan önce hedef indeksinizin mevcut olduğundan emin olun
  2. Toplu İşlemler: Daha iyi performans için birden fazla ekleme işlemini gruplayın
  3. Formatı Korumak: Biçimlendirilmiş satır/sütun eklerken stil kopyalamasını kullanın
  4. Kenarlık Durumlarını Test Edin: Sayfa sınırlarında (satır 1, sütun A) davranışı doğrulayın
  5. 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.

Curtis Chau
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ı...

Daha Fazla Oku
Başlamaya Hazır mısınız?
Nuget İndirmeler 2,052,917 | Sürüm: 2026.6 just released
Still Scrolling Icon

Hâlâ Kaydırıyor Musunuz?

Hızlıca kanıt ister misiniz? PM > Install-Package IronXL.Excel
örnek çalıştır verinizin bir hesap tablosu haline geldiğini izleyin.