Jak dodawać wiersze i kolumny w programie Excel jako programista C#

Jak wstawiać nowe wiersze i kolumny w języku C

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

Biblioteka IronXL oferuje wygodny sposób wstawiania pojedynczych lub wielu wierszy i kolumn w kodzie C# bez użycia Office Interop. Użyj metod InsertRows i InsertColumns na dowolnej pozycji indeksu, aby dynamicznie modyfikować arkusze Excel programowo.

Szybki start: Łatwe dodawanie wierszy lub kolumn za pomocą IronXL

IronXL umożliwia wstawianie wierszy lub kolumn w dowolnym miejscu za pomocą jednego płynnego wywołania API. Efektywnie modyfikuj arkusze Excel przy użyciu minimalnej ilości kodu.

  1. Install IronXL with NuGet Package Manager

    PM > Install-Package IronXl.Excel
  2. Skopiuj i uruchom ten fragment kodu.

    new WorkBook("example.xlsx").DefaultWorkSheet.InsertColumns(3, 2);
  3. Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie IronXL w swoim projekcie już dziś z darmową wersją próbną

    arrow pointer


Jak wstawić nowe wiersze w Excelu za pomocą języka C#?

Użyj metod InsertRow i InsertRows, aby dodać nowe wiersze do arkusza kalkulacyjnego. Metody te umożliwiają wstawianie wierszy w określonej pozycji indeksu. Dokumentacja API IronXL zawiera wyczerpujące informacje na temat wszystkich dostępnych metod manipulacji wierszami.

Zwróć uwagęWstawianie wierszy bezpośrednio w wierszu filtru może powodować konflikty w pliku Excel, co wymaga uruchomienia naprawy programu Excel w celu prawidłowego wyświetlenia arkusza kalkulacyjnego.

Jaka jest składnia dodawania pojedynczego wiersza?

: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

Metoda InsertRow przyjmuje jeden parametr wskazujący indeks zerowy, gdzie powinien zostać wstawiony nowy wiersz. Wszystkie istniejące wiersze znajdujące się w tej pozycji i poniżej zostaną automatycznie przesunięte w dół. W bardziej złożonych scenariuszach związanych z pracą z danymi można połączyć wstawianie wierszy z formułami i obliczeniami.

Jak działa wstawianie wielu wierszy?

Widoki arkusza kalkulacyjnego przed i po zmianie, przedstawiające tabelę danych pracowników z nowym wierszem wstawionym w pozycji 2

Podczas używania InsertRows określ zarówno początkowy indeks, jak i liczbę wierszy do wstawienia. Metoda ta okazuje się nieoceniona podczas przygotowywania szablonów danych lub dynamicznego rozszerzania zbiorów danych. Metoda ta zachowuje wszystkie istniejące formatowania i formuły, automatycznie dostosowując odwołania do komórek.

Jakie są typowe pułapki podczas dodawania wierszy?

Podczas programowego wstawiania wierszy może pojawić się kilka wyzwań:

  1. Niejednoznaczność indeksów: IronXL stosuje indeksowanie od zera, więc wiersz 1 w Excelu odpowiada indeksowi 0 w kodzie
  2. Granice tabel: Wstawianie wierszy w tabelach nazwanych wymaga szczególnej uwagi — zapoznaj się z naszym przewodnikiem dotyczącym tabel nazwanych
  3. Wpływ na wydajność: Podczas wstawiania wielu wierszy warto rozważyć operacje wsadowe w celu poprawy wydajności, zgodnie z opisem w naszych kamieniach milowych dotyczących wydajności
  4. Aktualizacje formuł: Odwołania do komórek w formułach aktualizują się automatycznie, ale odwołania bezwzględne pozostają niezmienne

Dlaczego pozycja w indeksie ma znaczenie?

Pozycja w indeksie określa, gdzie pojawi się nowy wiersz i jak przesuną się istniejące dane. Użycie nieprawidłowych indeksów może spowodować nadpisanie danych lub powstanie luk w arkuszu kalkulacyjnym. W przypadku złożonych scenariuszy manipulacji danymi warto zapoznać się z naszym przewodnikiem dotyczącym wyboru zakresów, aby lepiej zrozumieć pozycjonowanie.


Jak usunąć wiersze z arkusza Excel?

Aby usunąć wiersz z arkusza kalkulacyjnego, użyj metody GetRow, aby wybrać żądany wiersz, a następnie użyj metody RemoveRow na wybranym wierszu. Ten dwuetapowy proces zapewnia precyzyjną kontrolę nad tym, które dane zostaną usunięte.

Zwróć uwagęNie można usunąć wiersza nagłówkowego tabeli.

Jaka jest podstawowa składnia usuwania?

: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

Kiedy należy programowo usuwać wiersze?

Usunięcie wiersza okazuje się niezbędne w kilku scenariuszach:

  • Czyszczenie danych: Usuwanie pustych lub nieprawidłowych wierszy z zaimportowanych zbiorów danych
  • Dynamiczne filtrowanie: Usuń wiersze, które nie spełniają określonych kryteriów
  • Przygotowanie szablonu: Wyczyść dane przykładowe przed generowaniem raportów
  • Optymalizacja wydajności: Zmniejsz rozmiar pliku, usuwając niepotrzebne wiersze

Aby uzyskać bardziej zaawansowaną manipulację danymi, zapoznaj się z naszym poradnikiem o edycji plików Excel, który obejmuje kompleksowe techniki edycji.

Co się dzieje z danymi poniżej usuniętych wierszy?

Porównanie przed i po usunięciu wiersza pracownika E02035 Liliana Chang z tabeli danych pracowników

Kiedy usuniesz wiersz, wszystkie wiersze poniżej automatycznie przesuwają się w górę, aby wypełnić lukę. To utrzymuje ciągłość danych bez ręcznej interwencji. Formuły odwołujące się do usuniętego wiersza mogą zwracać błędy, dlatego warto zaktualizować zależne obliczenia. Aby dowiedzieć się, jak obsługiwać aktualizacje formuł, zobacz nasz przewodnik o edycji formuł.


Jak mogę dodać nowe kolumny do arkuszy kalkulacyjnych Excel?

Aby dodać nowe kolumny przed określonym indeksem w tabeli, użyj metod InsertColumn i InsertColumns. Te metody odwzorowują funkcjonalność wstawiania wierszy, ale działają na osi poziomej.

Zwróć uwagęWstawianie nowych kolumn w zakresie tabeli może powodować konflikty w pliku Excel, co wymaga uruchomienia naprawy Excel w celu prawidłowego wyświetlenia arkusza. To remove all empty rows and columns on the range borders, use the Trim() method. W tej chwili nie jest możliwe usunięcie kolumn.

Ostrzeżenie Wstawienie nowej kolumny do całkowicie pustego arkusza spowoduje System.InvalidOperationException z komunikatem 'Sequence contains no elements'.

Jakie kody dodają pojedyncze vs. wiele kolumn?

: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

Jak działa indeksowanie kolumn?

Indeksowanie kolumn odbywa się według tego samego wzorca zerowego, co wiersze:

  • Kolumna A = indeks 0
  • Kolumna B = indeks 1
  • Kolumna C = indeks 2

Ta spójność upraszcza pracę z oboma wymiarami twojego arkusza kalkulacyjnego. W połączeniu z formatowaniem danych w komórkach, można programowo tworzyć odpowiednio zbudowane tabele danych.

Jakie są ograniczenia operacji na kolumnach?

Porównanie przed i po pokazujące wstawienie nowej pustej kolumny między kolumnami Identyfikator pracownika a Pełna nazwa

Obecne ograniczenia obejmują:

  • Brak bezpośredniego usuwania kolumn: W przeciwieństwie do wierszy, kolumny nie mogą być bezpośrednio usunięte (obejście: skopiuj potrzebne dane do nowego arkusza)
  • Ograniczenia tabeli: Kolumny w nazwanych tabelach wymagają specjalnego traktowania
  • Maksymalny limit kolumn: Excel obsługuje do 16 384 kolumn (XFD)
  • Względy wydajnościowe: Duże wstawienia kolumn mogą znacząco wpływać na rozmiar pliku

Aby obejść te ograniczenia, nasz przewodnik rozwiązywania problemów z limitami rozmiaru pliku oferuje strategie optymalizacji.

PoradyWszystkie pozycje indeksu wierszy i kolumn są indeksowane od zera.

Najlepsze praktyki dotyczące operacji na wierszach i kolumnach

Podczas programowego modyfikowania struktury Excel:

  1. Zawsze weryfikuj indeksy: Sprawdź, czy twój docelowy indeks istnieje przed operacjami
  2. Operacje wsadowe: Grupuj wiele wstąpień dla lepszej wydajności
  3. Zachowaj formatowanie: Używaj kopii stylu podczas wstawiania sformatowanych wierszy/kolumn
  4. Testuj przypadki brzegowe: Weryfikuj zachowanie na granicach arkusza (wiersz 1, kolumna A)
  5. Obsługuj wyjątki: Implementuj właściwą obsługę błędów dla nieprawidłowych operacji

Dla kompleksowych przepływów automatyzacji Excel, zapoznaj się z naszym poradnikiem o tworzeniu plików Excel, który demonstruje te zasady w działaniu.

Często Zadawane Pytania

Jak wstawić nowe wiersze w Excelu używając C#?

Użyj metod InsertRow i InsertRows z IronXL, aby dodać nowe wiersze do arkuszy kalkulacyjnych Excel. Metoda InsertRow dodaje pojedynczy wiersz na określonej pozycji indeksu opartego na zerze, podczas gdy InsertRows pozwala na jednoczesne wstawienie wielu wierszy. IronXL automatycznie przenosi istniejące wiersze w dół i zachowuje formatowanie oraz formuły.

Jak wygląda składnia programowego dodawania kolumn do pliku Excel?

IronXL zapewnia metody InsertColumn i InsertColumns do dodawania kolumn do plików Excel. Podobnie jak przy wstawianiu wierszy, określasz pozycję indeksową, na której kolumny powinny zostać wstawione. Na przykład, InsertColumns(3, 2) wstawia 2 kolumny zaczynając od pozycji indeksu 3.

Czy mogę wstawiać wiersze i kolumny bez zainstalowanego Microsoft Office?

Tak, IronXL pozwala na wstawianie wierszy i kolumn do plików Excel bez potrzeby posiadania Microsoft Office lub Interop Office. To autonomiczna biblioteka C#, która działa bezpośrednio z formatami plików Excel, co czyni ją idealną dla środowisk serwerowych lub systemów bez instalacji Office.

Co dzieje się z istniejącymi danymi podczas wstawiania nowych wierszy lub kolumn?

Podczas używania metod wstawiania IronXL, istniejące dane są automatycznie przesuwane, aby pomieścić nowe wiersze lub kolumny. Wiersze przesuwają się w dół podczas wstawiania wierszy, a kolumny przesuwają się w prawo podczas wstawiania kolumn. Wszystkie formatowania, formuły i odwołania komórkowe są automatycznie dostosowywane.

Jak dodawać dane do nowo wstawionych wierszy i kolumn?

Po wstawieniu wierszy lub kolumn za pomocą IronXL, możesz wypełniać je używając standardowych metod przypisywania komórek. Biblioteka oferuje płynne API do uzyskiwania dostępu do komórek według ich współrzędnych, co pozwala na ustawianie wartości, formuł i formatowania w nowo utworzonym obszarze.

Jakie są typowe pułapki przy programowym dodawaniu wierszy?

Typowe wyzwania obejmują zamieszanie związane z indeksowaniem opartym na zerze (wiersz Excel 1 = indeks 0 w IronXL), konflikty przy wstawianiu na wiersze z filtrami oraz kwestie wydajności dla dużych operacji seryjnych. Dokumentacja IronXL dostarcza wskazówek dotyczących obsługi tabel nazwanych i optymalizacji wydajności dla masowych wstawień.

Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 1,950,735 | Wersja: 2026.4 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronXl.Excel
uruchom próbkę zobacz, jak Twoje dane stają się arkuszem.