Dodawanie arkuszy kalkulacyjnych do arkusza kalkulacyjnego projektanta za pomocą Aspose.Cells

Wstęp

Zarządzanie plikami Excel programowo to przełom, jeśli chodzi o automatyzację zadań, uproszczenie wprowadzania danych i tworzenie niestandardowych raportów. Jednym z potężnych narzędzi w przestrzeni .NET jest Aspose.Cells dla .NET, który zapewnia rozbudowaną funkcjonalność tworzenia, edytowania i zarządzania plikami Excel bez polegania na samym programie Microsoft Excel. W tym samouczku pokażemy, jak dodawać nowe arkusze kalkulacyjne do arkusza kalkulacyjnego projektanta za pomocą Aspose.Cells dla .NET, krok po kroku.

Wymagania wstępne

Zanim zagłębisz się w kod, oto czego będziesz potrzebować:

  1. Biblioteka Aspose.Cells dla .NET – PobierzBiblioteka Aspose.Cells dla .NET i dodaj go do swojego projektu. Aspose oferuje bezpłatną wersję próbną, ale możesz również uzyskaćlicencja tymczasowa aby uzyskać dostęp do wszystkich funkcji w fazie rozwoju.
  2. Podstawowa znajomość języka C# – Ponieważ używamy .NET, powinieneś znać składnię języka C#.
  3. Visual Studio lub zgodne ze standardem IDE – do wykonywania i testowania kodu potrzebne będzie zintegrowane środowisko programistyczne (IDE) zgodne ze standardem .NET, takie jak Visual Studio.

Importuj pakiety

Na początek musisz zaimportować przestrzeń nazw Aspose.Cells do swojego projektu. Umożliwia to dostęp do klas i metod potrzebnych do pracy z plikami Excel w .NET.

using System.IO;
using Aspose.Cells;
using System;

Teraz, gdy masz już wszystkie wymagania wstępne, przeanalizujmy każdą część kodu, aby zrozumieć, jak dodawać arkusze kalkulacyjne do istniejącego arkusza kalkulacyjnego.

Krok 1: Ustaw ścieżkę do katalogu dokumentów

Najpierw zdefiniujmy ścieżkę pliku, w którym przechowywany jest dokument Excela. To tutaj Aspose.Cells będzie szukać istniejącego pliku.

string dataDir = "Your Document Directory";
string inputPath = dataDir + "book1.xlsx";

W tym fragmencie kodu:

  • dataDir reprezentuje ścieżkę folderu dla twoich plików.
  • inputPath to pełna ścieżka do istniejącego pliku Excel (book1.xlsx w tym przypadku).

Krok 2: Otwórz plik Excel jako strumień plików

Aby pracować z plikiem Excel, utwórzFileStream. Otwiera plik w sposób umożliwiający Aspose.Cells odczytanie i manipulowanie jego zawartością.

FileStream fstream = new FileStream(inputPath, FileMode.Open);

Tutaj:

  • OtwieramyinputPath używającFileStream WOpentryb, który umożliwia dostęp do pliku z możliwością odczytu i zapisu.

Krok 3: Zainicjuj obiekt skoroszytu

Mając otwarty strumień plików, możemy zainicjowaćWorkbook obiekt. Ten obiekt reprezentuje plik Excel i jest punktem wejścia dla wszystkich operacji związanych z plikiem.

Workbook workbook = new Workbook(fstream);

W tym kroku:

  • TworzymyWorkbook obiekt o nazwieworkbook i przechodzącfstream aby Aspose.Cells mógł uzyskać dostęp do otwartego pliku Excel.

Krok 4: Dodaj nowy arkusz kalkulacyjny

Teraz dodajmy arkusz kalkulacyjny do naszego skoroszytu. Aspose.Cells udostępnia wygodną metodę o nazwieAdd() w tym celu.

int i = workbook.Worksheets.Add();

Oto co się dzieje:

  • Add() dodaje nowy arkusz na końcu skoroszytu.
  • int i przechowuje indeks nowego arkusza kalkulacyjnego, co jest przydatne, gdy musimy się do niego odwołać.

Krok 5: Uzyskaj odniesienie do nowego arkusza kalkulacyjnego

Po dodaniu arkusza kalkulacyjnego należy uzyskać do niego odniesienie. Ułatwia to manipulowanie lub dostosowywanie nowego arkusza kalkulacyjnego.

Worksheet worksheet = workbook.Worksheets[i];

Wyjaśnienie:

  • workbook.Worksheets[i] pobiera nowo dodany arkusz kalkulacyjny według jego indeksu i przypisujemy go doworksheet zmienny.

Krok 6: Ustaw nazwę nowego arkusza kalkulacyjnego

Aby skoroszyt był bardziej czytelny, nadaj nowemu arkuszowi znaczącą nazwę.

worksheet.Name = "My Worksheet";

W tym kroku:

  • Nadajemy nazwę"My Worksheet"do naszego nowo utworzonego arkusza kalkulacyjnego, używającName nieruchomość.

Krok 7: Zapisz zaktualizowany skoroszyt

Na koniec zapisz zmiany w nowym pliku Excel. W ten sposób oryginalny plik pozostanie niezmieniony, a zaktualizowana wersja będzie zawierać dodany arkusz kalkulacyjny.

workbook.Save(dataDir + "output.xlsx");

Wyjaśnienie:

  • workbook.Save() zapisuje skoroszyt idataDir + "output.xlsx" określa ścieżkę i nazwę pliku wyjściowego.

Krok 8: Zamknij strumień plików

Najlepszym rozwiązaniem jest zamknięcie strumienia plików po zakończeniu operacji w celu zwolnienia zasobów systemowych.

fstream.Close();

W tym kroku:

  • fstream.Close() zapewnia, że nasz strumień plików jest prawidłowo zamknięty, co jest ważne, gdyż zapobiega zablokowaniu pliku. I to wszystko! Pomyślnie dodano nowy arkusz kalkulacyjny do istniejącego pliku Excel przy użyciu Aspose.Cells dla .NET.

Wniosek

Używanie Aspose.Cells dla .NET do programowego dodawania arkuszy kalkulacyjnych do plików Excel jest proste, ale niezwykle potężne. Dzięki tej umiejętności możesz dynamicznie tworzyć niestandardowe arkusze kalkulacyjne, automatyzować powtarzające się wprowadzanie danych i strukturyzować raporty dokładnie tak, jak chcesz. Od dodawania arkuszy kalkulacyjnych po nadawanie im nazw i zapisywanie końcowego wyniku, ten samouczek obejmuje wszystkie podstawowe elementy.

Najczęściej zadawane pytania

1. Czy mogę dodać wiele arkuszy kalkulacyjnych na raz?

Tak, po prostu zadzwońAdd() Metodę tę można stosować wielokrotnie, aby dodać tyle arkuszy kalkulacyjnych, ile potrzeba.

2. Jak mogę sprawdzić liczbę arkuszy w skoroszycie?

Możesz użyćworkbook.Worksheets.Count aby uzyskać całkowitą liczbę arkuszy w skoroszycie.

3. Czy można dodać arkusz kalkulacyjny w określonym miejscu?

Tak, możesz określić pozycję za pomocąInsert metoda raczej niżAdd().

4. Czy mogę zmienić nazwę arkusza po jego dodaniu?

Absolutnie! Po prostu ustawName własnośćWorksheet sprzeciw wobec nowej nazwy.

5. Czy Aspose.Cells wymaga zainstalowania programu Microsoft Excel?

Nie, Aspose.Cells jest samodzielną biblioteką, więc nie ma potrzeby instalowania programu Excel na swoim komputerze.