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 oraz InsertColumns w dowolnej pozycji indeksu, aby dynamicznie modyfikować arkusze kalkulacyjne Excel za pomocą kodu.

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 zaczynający się od zera, w którym należy wstawić 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 korzystania z InsertRows należy określić zarówno indeks początkowy, 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. Nieporozumienie co do indeksów: IronXL używa indeksów zerowych, więc wiersz 1 w Excelu odpowiada indeksowi 0 w kodzie
  2. Granice tabeli: Wstawianie wierszy w ramach nazwanych tabel wymaga szczególnego rozważenia - zapoznaj się z naszym przewodnikiem na temat nazwanych tabel
  3. Wpływ na wydajność: Podczas wstawiania wielu wierszy rozważ operacje wsadowe, aby poprawić wydajność, jak szczegółowo opisano w naszych kamieniach milowych wydajności
  4. Aktualizacje formuł: Odwołania do komórek w formułach aktualizują się automatycznie, ale odwołania bezwzględne pozostają niezmienne

Dłączego 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.

InsertRow``InsertRows


Jak usunąć wiersze z arkusza Excel?

Aby usunąć wiersz z arkusza kalkulacyjnego, należy użyć metody GetRow w celu zaznaczenia żądanego wiersza, a następnie zastosować metodę RemoveRow na zaznaczonym 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:

  • Oczyszczanie danych: Usuń puste lub nieprawidłowe wiersze z zaimportowanych zbiorów danych
  • Filtrowanie dynamiczne: Usuń wiersze, które nie spełniają określonych kryteriów
  • Przygotowanie szablonu: Wyczyść przykładowe dane przed wygenerowaniem raportów
  • Optymalizacja wydajności: Zmniejsz rozmiar pliku, usuwając niepotrzebne wiersze

Dla bardziej zaawansowanej manipulacji danymi zapoznaj się z naszym samouczkiem na temat [edytowania plików Excel](https://ironsoftware.com/csharp excels how-to/csharp-edit-excel-file/), 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śloną pozycją indeksu w tabeli, należy użyć 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żeniePróba wstawienia nowej kolumny do całkowicie pustego arkusza spowoduje wyświetlenie System.InvalidOperationException z komunikatem "Sekwencja nie zawiera żadnych elementów".

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, kolumn nie można bezpośrednio usuwać (obejście: skopiuj potrzebne dane do nowego arkusza)
  • Ograniczenia tabel: Kolumny w ramach nazwanych tabel wymagają szczególnego traktowania
  • Maksymalny limit kolumn: Excel obsługuje do 16 384 kolumn (XFD)
  • Rozważania dotyczące wydajności: Duże wstawienia kolumn mogą znacząco wpłynąć 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 wstawień dla lepszej wydajności
  3. Zachowaj formatowanie: Użyj kopiowania stylu podczas wstawiania sformatowanych wierszy/kolumn
  4. Przetestuj przypadki brzegowe: Zweryfikuj zachowanie na granicach arkusza (wiersz 1, kolumna A)
  5. Obsługuj wyjątki: Zaimplementuj właściwe przetwarzanie 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 2,052,917 | Wersja: 2026.6 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.