Utwórz wykres PDF z żądanym rozmiarem strony

Wstęp

Tworzenie atrakcyjnych wizualnie i informacyjnych wykresów jest niezbędne do reprezentacji danych w różnych dziedzinach. Niezależnie od tego, czy masz do czynienia z danymi sprzedaży, metrykami wydajności czy jakimkolwiek innym rodzajem informacji, możliwość tworzenia wysokiej jakości wykresów zapewnia Twoim odkryciom głębię i przejrzystość. Jeśli pracujesz z aplikacjami .NET, Aspose.Cells to potężna biblioteka, która sprawia, że obsługa dokumentów Excel i generowanie wykresów to pestka. W tym samouczku przeprowadzimy Cię przez proces tworzenia pliku PDF wykresu z pliku Excel o pożądanym rozmiarze strony.

Wymagania wstępne

Zanim zagłębisz się w kod, musisz spełnić kilka warunków wstępnych, aby zapewnić sobie płynne działanie:

Podstawowa wiedza z zakresu C# i .NET

Będziesz potrzebować podstawowej wiedzy na temat programowania w języku C# i środowiska .NET. Pomoże ci to zrozumieć strukturę kodu, który napotkasz w tym przewodniku.

Aspose.Cells dla .NET

Upewnij się, że masz zainstalowany Aspose.Cells dla .NET. Wszystkie szczegóły znajdziesz na Dokumentacja Aspose.Cells .

Środowisko programistyczne

Skonfiguruj środowisko programistyczne. Może to być Visual Studio lub dowolne inne IDE obsługujące C#. Pobierz i zainstaluj bibliotekę Aspose.Cells z strona do pobrania .

Przykładowy plik Excela

Będziesz potrzebować przykładowego pliku Excel, który zawiera co najmniej jeden wykres. Możesz utworzyć przykładowy plik lub pobrać jeden, aby używać go w tym samouczku.

Importuj pakiety

Aby rozpocząć pracę z Aspose.Cells, musisz zaimportować niezbędne przestrzenie nazw do swojej aplikacji C#. Oto jak to zrobić:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

using Aspose.Cells.Charts;

Te przestrzenie nazw zapewniają dostęp do klas i metod potrzebnych do manipulowania skoroszytami programu Excel i ich zawartością.

Teraz, gdy zadbaliśmy już o wszystkie szczegóły, możemy podzielić proces na szczegółowe kroki.

Krok 1: Konfiguracja katalogów wyjściowych i źródłowych

Na początek musisz określić, gdzie zostanie zapisany wyjściowy plik PDF i gdzie znajduje się źródłowy dokument Excel.

//Katalog wyjściowy
string outputDir = "Your Output Directory";

//Katalog źródłowy
string sourceDir = "Your Document Directory";

Upewnij się, że zastąpiłeś „Twój katalog wyjściowy” i „Twój katalog dokumentów” rzeczywistymi ścieżkami w swoim systemie. To dyktuje, gdzie Aspose zapisze wygenerowany plik PDF i gdzie znajdzie plik Excel.

Krok 2: Załaduj przykładowy plik Excel

Następnie musisz załadować plik Excel zawierający wykres. Oto jak to zrobić:

//Załaduj przykładowy plik Excel zawierający wykres.
Workbook wb = new Workbook(sourceDir + "sampleCreateChartPDFWithDesiredPageSize.xlsx");

TenWorkbook Klasa jest kluczowa dla interakcji z dokumentem Excel. Upewnij się, że ścieżka wskazuje poprawnie plik Excel — błąd w tym miejscu uniemożliwi wykonanie reszty kodu.

Krok 3: Uzyskaj dostęp do pierwszego arkusza kalkulacyjnego

Po załadowaniu skoroszytu następnym krokiem jest uzyskanie dostępu do arkusza zawierającego żądany wykres.

//Otwórz pierwszy arkusz kalkulacyjny.
Worksheet ws = wb.Worksheets[0];

W Aspose.Cells arkusze kalkulacyjne są indeksowane od zera, więcWorksheets[0] odnosi się do pierwszego arkusza.

Krok 4: Uzyskaj dostęp do pierwszego wykresu

Teraz uzyskajmy dostęp do wykresu, który chcesz wyeksportować do pliku PDF. Ten krok zakłada, że arkusz zawiera co najmniej jeden wykres.

//Otwórz pierwszy wykres w arkuszu kalkulacyjnym.
Chart ch = ws.Charts[0];

Ponownie uzyskujemy dostęp do pierwszego wykresu w arkuszu kalkulacyjnym. Należy upewnić się, że struktura arkusza kalkulacyjnego jest dostosowana do tego podejścia.

Krok 5: Utwórz plik PDF z żądanym rozmiarem strony

Na koniec nadszedł czas na utworzenie pliku PDF z wykresu o określonym rozmiarze strony. Oto magiczna linia kodu, która robi to wszystko:

//Utwórz wykres w formacie PDF z wybranym rozmiarem strony.
ch.ToPdf(outputDir + "outputCreateChartPDFWithDesiredPageSize.pdf", 7, 7, PageLayoutAlignmentType.Center, PageLayoutAlignmentType.Center);

W tym kodzie:

  • Plik PDF zostanie zapisany w określonym wcześniej katalogu wyjściowym.
  • Księga Liczb7, 7 reprezentują odpowiednio szerokość i wysokość pożądanego rozmiaru strony.
  • PageLayoutAlignmentType.Center zapewnia wyśrodkowanie wykresu na stronie.

Krok 6: Wiadomość potwierdzająca

Aby dać znać (i dać znać innym), że wszystko poszło gładko, na końcu kodu umieść komunikat potwierdzający:

Console.WriteLine("CreateChartPDFWithDesiredPageSize executed successfully.");

Ten komunikat pojawi się w oknie konsoli po zakończeniu procesu, sygnalizując, że plik PDF został utworzony bez żadnych problemów.

Wniosek

Gratulacje! Właśnie nauczyłeś się, jak wykorzystać Aspose.Cells dla .NET do tworzenia pliku PDF z wykresu zawartego w pliku Excel. Ta potężna biblioteka usprawnia proces manipulowania dokumentami Excel i generowania wizualnych reprezentacji danych, oszczędzając Ci godzin ręcznego formatowania. Koniecznie zapoznaj się z mnogością innych funkcji, które Aspose.Cells oferuje poza generowaniem PDF — nigdy nie wiesz, co może jeszcze bardziej ulepszyć Twoje projekty!

Najczęściej zadawane pytania

Do czego służy Aspose.Cells for .NET?

Aspose.Cells for .NET służy do programistycznego tworzenia, edytowania i konwertowania dokumentów Excel w aplikacjach .NET.

Czy mogę używać Aspose.Cells za darmo?

Tak, Aspose.Cells oferuje bezpłatny okres próbny w celach ewaluacyjnych.

Czy istnieje możliwość przedłużenia okresu próbnego poza okres początkowy?

Możesz złożyć wniosek o licencja tymczasowa do rozszerzonego testowania.

Co zrobić, jeśli napotkam problemy lub będę miał pytania?

Możesz szukać pomocy u społeczności Aspose na ich stronie forum wsparcia .

Jak mogę kupić Aspose.Cells?

Możesz kupić Aspose.Cells w strona zakupu .