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 naDokumentacja 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 zstrona 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 oferujebezpł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 olicencja 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 stronieforum wsparcia.

Jak mogę kupić Aspose.Cells?

Możesz kupić Aspose.Cells wstrona zakupu.