Eksportuj właściwości niestandardowe do pliku PDF z programu Excel

Wstęp

Podczas pracy z plikami Excel często pojawia się potrzeba udostępniania danych w powszechnie akceptowanym formacie, takim jak PDF. Eksportowanie niestandardowych właściwości z plików Excel do plików PDF może być trudnym zadaniem bez odpowiednich narzędzi. Właśnie tutaj pojawia się Aspose.Cells dla .NET, oferując solidne rozwiązanie, które sprawia, że ten proces jest płynny i wydajny. W tym artykule przeprowadzimy Cię przez kroki wymagane do eksportowania niestandardowych właściwości z pliku Excel do formatu PDF przy użyciu Aspose.Cells dla .NET. Pod koniec tego przewodnika będziesz wyposażony we całą wiedzę potrzebną do podjęcia się tego zadania!

Wymagania wstępne

Zanim przejdziemy do szczegółów, omówmy kilka warunków wstępnych, które będą Ci potrzebne:

  1. Środowisko .NET: Upewnij się, że masz skonfigurowane środowisko programistyczne .NET, np. Visual Studio.
  2. Aspose.Cells dla .NET: Pobierz i zainstaluj najnowszą wersję Aspose.Cells dla .NET. Możesz ją znaleźćTutaj.
  3. Podstawowa znajomość języka C#: Znajomość programowania w języku C# pomoże Ci łatwiej zrozumieć przykłady kodu.

Importuj pakiety

Aby zacząć, musisz najpierw zaimportować niezbędne pakiety do swojego projektu. Oto, jak możesz to zrobić:

Utwórz nowy projekt

  1. Otwórz program Visual Studio.
  2. Kliknij „Utwórz nowy projekt”.
  3. Wybierz „Aplikacja konsolowa (.NET Framework)” lub „Aplikacja konsolowa (.NET Core)” w zależności od swoich preferencji i kliknij „Dalej”.
  4. Nadaj nazwę swojemu projektowi i kliknij „Utwórz”.

Dodaj Aspose.Cells do swojego projektu

Aby użyć Aspose.Cells, musisz dodać je jako odniesienie:

  1. Kliknij prawym przyciskiem myszy projekt w Eksploratorze rozwiązań.
  2. Wybierz „Zarządzaj pakietami NuGet”.
  3. Wyszukaj „Aspose.Cells” i zainstaluj najnowszą wersję. Teraz, gdy Twoje pakiety zostały zaimportowane, możesz rozpocząć kodowanie.
using System.IO;
using System.Web;
using Aspose.Cells;
using System;

Przejdźmy teraz do najważniejszej części: przewodnika krok po kroku dotyczącego eksportowania niestandardowych właściwości z pliku Excel do dokumentu PDF. Zapnijcie pasy!

Krok 1: Skonfiguruj swoje katalogi

Zanim zaczniesz kodować, musisz zdefiniować katalogi wejściowe i wyjściowe. To tutaj będziesz czytać plik Excel i gdzie zostanie zapisany wygenerowany plik PDF.

// Katalog wejściowy
string sourceDir = "Your Document Directory";
// Katalog wyjściowy
string outputDir = "Your Document Directory";

W tym fragmencie kodu zamień"Your Document Directory" z rzeczywistą ścieżką, gdzie znajdują się Twoje pliki lub gdzie chcesz je zapisać.

Krok 2: Załaduj plik Excel

Następnie musisz załadować plik Excela zawierający niestandardowe właściwości. Można to zrobić za pomocąWorkbook Klasa w Aspose.Cells.

// Załaduj plik Excel zawierający właściwości niestandardowe
Workbook workbook = new Workbook(sourceDir + "sampleWithCustProps.xlsx");

Tutaj upewnij się, żesampleWithCustProps.xlsx jest nazwą Twojego dokumentu Excel, który powinien znajdować się w określonym katalogu.

Krok 3: Utwórz PdfSaveOptions

Gdy twój skoroszyt zostanie załadowany, czas skonfigurować opcje zapisywania pliku PDF. Utworzysz wystąpieniePdfSaveOptions i ustaw odpowiednie właściwości.

// Utwórz instancję PdfSaveOptions i przekaż SaveFormat do konstruktora
Aspose.Cells.PdfSaveOptions pdfSaveOpt = new Aspose.Cells.PdfSaveOptions();

Ten wiersz uruchamia opcje zapisu w formacie PDF, które za chwilę dostosujesz.

Krok 4: Skonfiguruj eksport niestandardowych właściwości

Będziesz chciał określić, jak mają być eksportowane właściwości niestandardowe. W tym przypadku użyjemyStandard opcja eksportu.

// Ustaw właściwość CustomPropertiesExport na PdfCustomPropertiesExport.Standard
pdfSaveOpt.CustomPropertiesExport = Aspose.Cells.Rendering.PdfCustomPropertiesExport.Standard;

Po ustawieniu tej właściwości niestandardowe właściwości z dokumentu programu Excel zostaną uwzględnione w pliku PDF.

Krok 5: Zapisz skoroszyt jako plik PDF

Gdy wszystko jest już gotowe, czas zapisać skoroszyt jako plik PDF, korzystając ze zdefiniowanych opcji.

// Zapisz skoroszyt w formacie PDF, przekazując obiekt PdfSaveOptions
workbook.Save(outputDir + "outSampleWithCustProps.pdf", pdfSaveOpt);

W tej linii,outSampleWithCustProps.pdf będzie nazwą nowego pliku PDF, więc upewnij się, że jest unikatowa, by uniknąć nadpisania.

Krok 6: Potwierdź powodzenie

Na koniec sprawdźmy, czy operacja zakończyła się powodzeniem, wyświetlając komunikat na konsoli:

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

Ten komunikat pojawi się na Twojej konsoli, aby poinformować Cię, że wszystko przebiegło pomyślnie.

Wniosek

masz to! Nauczyłeś się, jak eksportować niestandardowe właściwości z pliku Excel do dokumentu PDF przy użyciu Aspose.Cells dla .NET. To podejście nie tylko ułatwia udostępnianie danych, ale także zapewnia, że niestandardowe metadane wprowadzone do plików Excel pozostają nienaruszone i dostępne w formacie PDF. Niezależnie od tego, czy masz do czynienia z dokumentacją projektu, raportami czy podsumowaniami danych, ta metoda jest cennym dodatkiem do Twojego zestawu narzędzi. Nie wahaj się zapoznać z dokumentacją Aspose.CellsTutaj dla jeszcze bardziej zaawansowanych funkcjonalności.

Najczęściej zadawane pytania

Czym są właściwości niestandardowe w programie Excel?

Właściwości niestandardowe to pola metadanych, które można skojarzyć ze skoroszytem programu Excel, np. nazwisko autora, tytuł lub dane niestandardowe dostosowane do konkretnych potrzeb.

Czy mogę eksportować właściwości niestandardowe w różnych formatach?

Tak, oprócz PDF, inne formaty obsługiwane przez Aspose.Cells także pozwalają na eksportowanie niestandardowych właściwości, w zależności od potrzeb.

Czy Aspose.Cells wymaga licencji?

Do użytku komercyjnego wymagana jest licencja, ale możesz również wypróbować produkt za darmo. Sprawdźlicencja tymczasowa opcje.

Gdzie mogę znaleźć pomoc dotyczącą Aspose.Cells?

Wsparcie społeczności i zadawanie pytań znajdziesz na forum AsposeTutaj.

Czy mogę dostosować zapisany plik PDF?

Absolutnie!PdfSaveOptions Klasa ta udostępnia różne właściwości umożliwiające szczegółową personalizację wyników PDF.

Zachowaj separatory dla pustych wierszy w programie Excel