W dzisiejszym krajobrazie cyfrowym, HTML jest jednym z najczęściej używanych formatów do wyświetlania i udostępniania danych strukturalnych online. Jednak w przypadku archiwizacji, dystrybucji lub dostępu offline, PDF pozostaje formatem wyboru. Programiści często muszą konwertować HTML na PDF, aby tworzyć raporty, faktury lub zachować zawartość stron internetowych w formacie uniwersalnie kompatybilnym.

Ten artykuł obejmuje następujące tematy:

HTML do PDF Konwersja SDKi

GroupDocs.Conversion Cloud SDK for .NET oferuje potężne i skalowalne rozwiązanie do transformacji formatów plików. Korzystając z możliwości tego interfejsu API, możesz płynnie konwertować HTML na PDF, zapewniając dokładność, spójność i doskonałą wydajność - wszystko to bez instalowania dodatkowego oprogramowania.

Zaczynając z konwersją HTML na PDF

Zanim zaczniesz, upewnij się, że masz następujące wymagania wstępne:

  1. Konto GroupDocs Cloud account, aby uzyskać swój identyfikator klienta i tajny klucz klienta. Aby uzyskać więcej informacji, odwiedź krótki tutorial.
  2. Przykładowy plik HTML lub strona internetowa do testowania.
  3. Skonfigurowane środowisko deweloperskie .NET (takie jak Visual Studio lub Rider).

Możesz zainstalować SDK z Menedżera Pakietów NuGet, uruchamiając następujące polecenie:

Install-Package GroupDocs.Conversion-Cloud -Version 25.9.0

Konwertuj HTML na PDF za pomocą C#

Zbadajmy, jak programowo wykonać konwersję HTML na PDF przy użyciu C# i GroupDocs Cloud SDK.

  1. Utwórz instancję klasy Configuration, w której przekazujemy dane uwierzytelniające klienta jako argumenty.
var configuration = new Configuration
{
    AppSid = "YOUR_CLIENT_ID",
    AppKey = "YOUR_CLIENT_SECRET"
};
  1. Zainicjuj instancję ConvertApi i FileApi, gdzie przekazujemy obiekt Configuration jako argumenty.
var convertApi = new ConvertApi(configuration);
var fileApi = new FileApi(configuration);
  1. Prześlij HTML do chmury.
using (var stream = File.OpenRead("source.html"))
{
    var uploadRequest = new UploadFileRequest("source.html", stream);
    fileApi.UploadFile(uploadRequest);
}
  1. Utwórz instancję ConvertSettings, w której określimy nazwę pliku wejściowego HTML, format wyjściowy jako pdf oraz nazwę rezultatu PDF.
var settings = new ConvertSettings
{
    FilePath = "index.html",
    Format = "pdf",
    OutputPath = "converted/html-to-pdf-result.pdf"
};
  1. Zadzwoń do ConvertDocumentRequest API, aby przekształcić HTML na format PDF. Po pomyślnej konwersji wynikowy plik PDF jest przechowywany w chmurze.
var request = new ConvertDocumentRequest(settings);
convertApi.ConvertDocument(request);

Po wykonaniu żądania, twój plik HTML zostanie przekształcony w wysokiej jakości PDF i zapisany w określonym folderze wyjściowym w twojej chmurze.

HTML to PDF Conversion using cURL

Jeśli wolisz wykonywać konwersje za pomocą skryptów lub automatyzacji, cURL jest doskonałą alternatywą. Pozwala na wykonywanie wywołań API REST bezpośrednio z linii poleceń, co czyni go idealnym do szybkiego testowania i przetwarzania wsadowego.

Why Use cURL for HTML to PDF Conversion?

  • Nie wymagana jest instalacja SDK.
  • Idealne do skryptów powłoki, procesów CI/CD lub usług backendowych.
  • Lekki i łatwy do automatyzacji.

Przed uruchomieniem polecenia konwersji HTML na PDF, wygeneruj swój token dostępu JWT, oparty na danych uwierzytelniających klienta. Po wygenerowaniu tokena wykonaj proszę następujące polecenie.

curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d "{  \"StorageName\": \"internal\",  \"FilePath\": \"{sourceFile}\",  \"Format\": \"pdf\",  \"LoadOptions\": {    \"Format\": \"html\"  },  \"ConvertOptions\": {    \"FromPage\": 1,    \"PagesCount\": 1,    \"Pages\": [      1    ],    \"WatermarkOptions\": {      \"Text\": \"Confidential\",      \"FontName\": \"Arial\",      \"FontSize\": 12,      \"Bold\": false,      \"Italic\": true,      \"Color\": \"Red\",      \"Width\": 10,      \"Height\": 6,      \"Top\": 100,      \"Left\": 100,      \"RotationAngle\": 10,      \"Transparency\": 0.8,      \"Background\": true,      \"AutoAlign\": true    }  },  \"OutputPath\": \"{converted}\"}"

Zastąp {ACCESSTOKEN} swoim wygenerowanym tokenem JWT i index.html nazwą swojego pliku HTML.

Wypróbuj darmowy konwerter HTML na PDF.

Jeśli chcesz zbadać proces konwersji bez pisania jakiegoś kodu, spróbuj darmowego HTML to PDF Converter aplikacja sieciowa napędzana przez GroupDocs.Conversion Cloud. Dzięki niej możesz przesłać dowolny plik HTML lub URL i natychmiast pobrać wygenerowany plik PDF.

html to pdf converter

Przydatne linki

Wnioski

Konwertowanie HTML na PDF za pomocą .NET REST API zapewnia programistom niezawodny sposób na zachowanie układów stron internetowych, stylów i treści w przenośnym formacie. Dzięki GroupDocs.Conversion Cloud SDK dla .NET możesz zautomatyzować ten proces w zaledwie kilku linijkach kodu — niezależnie od tego, czy potrzebujesz konwertować pojedyncze pliki HTML, czy całe partie stron internetowych.

Powiązane artykuły

Zalecamy odwiedzenie następujących linków, aby dowiedzieć się więcej o:

Często zadawane pytania (FAQ)

  1. How can I convert HTML to PDF using C# .NET?
  • Możesz użyć GroupDocs.Conversion Cloud SDK dla .NET, aby przesłać plik HTML, skonfigurować format wyjściowy jako PDF i wykonać metodę ConvertDocument(), aby wygenerować skonwertowany plik.
  1. Czy to API obsługuje konwersję HTML z CSS i obrazami?
  • Tak. SDK zarządza wszystkimi powiązanymi zasobami, zapewniając, że twój skonwertowany PDF zachowuje układ, czcionki, obrazy i stylizację dokładnie.
  1. Czy mogę bezpośrednio konwertować strony internetowe z adresów URL?
  • Tak. Możesz określić adres URL strony internetowej w ścieżce wejściowej, a interfejs API wygeneruje zawartość HTML i przekształci ją w dokument PDF.
  1. Czy muszę instalować jakieś narzędzia firm trzecich, takie jak Adobe Acrobat?
  • Nie. Cały proces jest oparty na chmurze—nie jest wymagana lokalna instalacja ani dodatkowe oprogramowanie.