Formatowanie obiektu listy w programie Excel za pomocą Aspose.Cells

Wstęp

Czy kiedykolwiek chciałeś, aby Twoje dane w Excelu się wyróżniały? Cóż, jeśli pracujesz z plikami Excela w .NET, Aspose.Cells to fantastyczna biblioteka, która może to zrobić. To narzędzie pozwala programowo tworzyć, formatować i stylizować tabele, wśród wielu innych zaawansowanych zadań w Excelu. Dzisiaj zagłębimy się w konkretny przypadek użycia: formatowanie obiektu listy (lub tabeli) w Excelu. Pod koniec tego samouczka będziesz wiedział, jak utworzyć tabelę danych, dodać styl, a nawet ustawić obliczenia podsumowujące.

Wymagania wstępne

Zanim zaczniesz kodować, upewnij się, że masz przygotowane kilka rzeczy:

  1. Visual Studio lub dowolne środowisko IDE .NET: Będziesz potrzebować środowiska programistycznego, aby pisać i uruchamiać kod .NET.
  2. Aspose.Cells dla .NET: Upewnij się, że masz zainstalowaną bibliotekę Aspose.Cells. Możesz ją pobrać ze stronyStrona pobierania Aspose.Cells dla .NET lub zainstaluj go poprzez NuGet w Visual Studio.
  3. Podstawowa wiedza na temat platformy .NET: Niniejszy przewodnik zakłada znajomość języka C# i platformy .NET.
  4. Licencja Aspose (opcjonalna): Aby uzyskać pełną funkcjonalność bez znaków wodnych, rozważ zakuplicencja tymczasowa lub kup jedenTutaj.

Importuj pakiety

Gdy wszystko będzie gotowe, dodaj niezbędne dyrektywy using do swojego kodu. Dzięki temu wszystkie funkcjonalności Aspose.Cells będą dostępne w Twoim projekcie.

using System.IO;
using Aspose.Cells;

Podzielmy ten proces na łatwe do zrozumienia kroki, dla każdego z których otrzymasz jasne instrukcje.

Krok 1: Skonfiguruj katalog dokumentów

Przed zapisaniem jakichkolwiek plików określmy katalog, w którym zostaną zapisane nasze pliki wyjściowe. Ta ścieżka katalogu zostanie użyta do utworzenia i zapisania wynikowego pliku Excel.

string dataDir = "Your Document Directory";
// Sprawdź czy katalog istnieje, jeśli nie, utwórz go
if (!System.IO.Directory.Exists(dataDir))
    System.IO.Directory.CreateDirectory(dataDir);

Krok 2: Utwórz nowy skoroszyt

Skoroszyt w programie Excel jest jak nowy plik lub arkusz kalkulacyjny. Tutaj tworzymy nowe wystąpienieWorkbook klasa do przechowywania naszych danych.

Workbook workbook = new Workbook();

Krok 3: Uzyskaj dostęp do pierwszego arkusza kalkulacyjnego

Każdy nowy skoroszyt ma domyślnie co najmniej jeden arkusz. Tutaj pobierzemy ten pierwszy arkusz do pracy.

Worksheet sheet = workbook.Worksheets[0];

Krok 4: Wypełnij komórki danymi

Teraz nadchodzi zabawna część — dodawanie danych! Wypełnijmy serię komórek, aby zbudować prostą tabelę danych. Te dane mogą reprezentować mały zestaw danych, taki jak kwartalna sprzedaż według pracowników i regionów.

Cells cells = sheet.Cells;
// Dodaj nagłówki
cells["A1"].PutValue("Employee");
cells["B1"].PutValue("Quarter");
cells["C1"].PutValue("Product");
cells["D1"].PutValue("Continent");
cells["E1"].PutValue("Country");
cells["F1"].PutValue("Sale");
// Dodaj przykładowe dane
cells["A2"].PutValue("David");
cells["A3"].PutValue("David");
// Dodaj więcej wierszy...
cells["B2"].PutValue(1);
cells["C2"].PutValue("Maxilaku");
// Kontynuuj dodawanie większej ilości danych zgodnie z wymaganiami

Te dane są tylko przykładem. Możesz je dostosować do swoich konkretnych potrzeb.

Krok 5: Dodaj obiekt listy (tabelę) do arkusza kalkulacyjnego

W programie Excel „obiekt listy” odnosi się do tabeli. Dodajmy ten obiekt listy do zakresu zawierającego nasze dane. Ułatwi to stosowanie funkcji formatowania i podsumowania.

Aspose.Cells.Tables.ListObject listObject = sheet.ListObjects[sheet.ListObjects.Add("A1", "F15", true)];

Tutaj,"A1" Do"F15" to zakres obejmujący nasze dane.true Parametr oznacza, że pierwszy wiersz (Wiersz 1) powinien być traktowany jako nagłówek.

Krok 6: Stylizuj tabelę

Teraz, gdy nasza tabela jest skonfigurowana, dodajmy do niej trochę stylu. Aspose.Cells zapewnia szereg wstępnie zdefiniowanych stylów tabeli, spośród których możesz wybierać. Tutaj zastosujemy styl średni.

listObject.TableStyleType = TableStyleType.TableStyleMedium10;

Eksperymentuj z różnymi stylami (takimi jakTableStyleMedium9 LubTableStyleDark1) aby znaleźć taki, który odpowiada Twoim potrzebom.

Krok 7: Wyświetl wiersz sum

Dodajmy wiersz sumaryczny, aby podsumować nasze dane.ShowTotals Właściwość umożliwi dodanie nowego wiersza na dole tabeli.

listObject.ShowTotals = true;

Krok 8: Ustaw typ obliczeń dla wiersza sum

W wierszu sum możemy określić, jaki typ obliczeń chcemy dla każdej kolumny. Na przykład policzmy liczbę wpisów w kolumnie „Kwartał”.

listObject.ListColumns[1].TotalsCalculation = TotalsCalculation.Count;

Ten wiersz kodu ustawia obliczenia sum dla kolumny „Kwartał” naCount Możesz również użyć opcji takich jakSum, Averagei więcej, w zależności od Twoich potrzeb.

Krok 9: Zapisz skoroszyt

Na koniec zapiszmy skoroszyt jako plik programu Excel w katalogu, który wcześniej utworzyliśmy.

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

Spowoduje to utworzenie w pełni sformatowanego i wystylizowanego pliku programu Excel zawierającego tabelę.

Wniosek

oto masz — w pełni stylizowaną, funkcjonalną tabelę Excela utworzoną programowo za pomocą Aspose.Cells dla .NET. Postępując zgodnie z tym samouczkiem, nauczyłeś się, jak skonfigurować tabelę danych, dodawać style i obliczać sumy, wszystko za pomocą zaledwie kilku linijek kodu. Aspose.Cells to potężne narzędzie, dzięki któremu możesz tworzyć dynamiczne, wizualnie atrakcyjne dokumenty Excela bezpośrednio z aplikacji .NET.

Najczęściej zadawane pytania

Czym jest Aspose.Cells?

Aspose.Cells to biblioteka .NET zaprojektowana, aby pomóc programistom programowo tworzyć, manipulować i konwertować pliki Excel. Zapewnia potężne opcje do pracy z arkuszami kalkulacyjnymi, wykresami, tabelami i innymi.

Czy mogę wypróbować Aspose.Cells za darmo?

Tak, możesz dostaćbezpłatny okres próbny Aspose.Cells, aby poznać jego funkcje. Aby uzyskać pełny dostęp bez ograniczeń, rozważ uzyskanielicencja tymczasowa.

Jak dodać więcej stylów do tabeli w programie Excel?

Aspose.Cells oferuje różnorodneTableStyleType opcje stylów tabel. Wypróbuj różne wartości, takie jakTableStyleLight1 LubTableStyleDark10 aby zmienić wygląd tabeli.

Czy mogę używać niestandardowych formuł w wierszu sum?

Oczywiście! Możesz ustawić własne formuły za pomocąListColumn.TotalsCalculationwłaściwość umożliwiająca zastosowanie określonych obliczeń, takich jak suma, średnia lub niestandardowe formuły.

Czy można zautomatyzować pliki Excela bez zainstalowanego programu Excel?

Tak, Aspose.Cells to samodzielny interfejs API, który nie wymaga instalacji programu Microsoft Excel na serwerze ani komputerze, na którym uruchamiany jest kod.