Konwertuj HTML na PDF w C# .NET

Zapotrzebowanie na wydajne rozwiązania do zarządzania dokumentami stale rośnie wykładniczo. W tym artykule zagłębiamy się w korzyści i praktyczne zastosowania wykorzystania interfejsu .NET Cloud API do konwersji HTML na PDF. Od usprawnienia przepływów pracy po zapewnienie zgodności na różnych platformach — odkryj, jak ta funkcja może znacznie zwiększyć produktywność i uprościć zadania związane z zarządzaniem dokumentami.

Ten artykuł obejmuje następujące tematy:

Interfejs API konwersji HTML na PDF

Zamierzamy zbadać solidne możliwości GroupDocs.Conversion Cloud SDK dla .NET i jego kluczową rolę w bezproblemowej realizacji wymagań konwersji HTML na PDF. Ponieważ firmy i programiści poszukują wydajnych rozwiązań do zarządzania dokumentami, ten interfejs API okazuje się potężnym narzędziem oferującym niezrównaną łatwość i wszechstronność. Przyjrzyjmy się, w jaki sposób ten zestaw SDK do konwersji umożliwia bezproblemową konwersję plików HTML do formatu PDF, ułatwiając płynniejszy przepływ pracy i zwiększając produktywność.

Teraz, aby móc korzystać z SDK, pierwszym krokiem jest jego instalacja. Po prostu wyszukaj GroupDocs.Conversion-Cloud w menedżerze pakietów NuGet i kliknij przycisk Instaluj. Inną opcją jest wykonanie następującego polecenia w konsoli menedżera pakietów.

NuGet\Install-Package GroupDocs.Conversion-Cloud -Version 24.2.0

Po pomyślnym zainstalowaniu interfejsu API REST upewnij się, że masz poświadczenia interfejsu API (tj. identyfikator klienta i klucz tajny klienta).Możesz odwiedzić ten krótki samouczek, aby dowiedzieć się, jak uzyskać dane uwierzytelniające API.

Konwertuj HTML na PDF za pomocą C# .NET

W tej sekcji omówimy szczegóły dotyczące programowej konwersji HTML na PDF przy użyciu języka C# .NET.

  1. Utwórz instancję klasy „Configuration”, w której przekazujemy referencje klienta jako argumenty.
var configurations = new Configuration(clientId, clientSecret1);
  1. Zainicjuj ConvertApi, w którym przekazujemy obiekt konfiguracyjny jako argument wejściowy.
var apiInstance = new ConvertApi(configurations);
  1. Prześlij wejściowy plik HTML do magazynu w chmurze, gdzie podajemy nazwę wejściowego pliku HTML.
fileUpload.UploadFile(new UploadFileRequest("input.html", stream));
  1. Utwórz instancję „ConvertSettings”, w której określimy nazwę wejściowego kodu HTML, format wyjściowy jako „pdf” i nazwę wynikowego dokumentu PDF.
var settings = new ConvertSettings{...}
  1. Wywołaj interfejs API ConvertDocumentRequest, aby przekonwertować HTML na format PDF. Po pomyślnej konwersji powstały plik PDF jest przechowywany w chmurze.
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));

// Więcej przykładów na https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// Uzyskaj dane uwierzytelniające API 
string clientId = "4bdefca3-f08c-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "a43c8b4365246a062688a259abe5b469";

// Utwórz instancję klasy Konfiguracja i zainicjuj ją za pomocą identyfikatora klienta i klucza tajnego klienta. 
var configurations = new GroupDocs.Conversion.Cloud.Sdk.Client.Configuration(clientId, clientSecret1);
// Zdefiniuj wartość ApiBaseUrl, aby ustawić podstawowy adres URL interfejsu API konwertera HTML na PDF.
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

// Zainicjuj instancję klasy ConvertApi obiektem klasy Configuration.
var apiInstance = new GroupDocs.Conversion.Cloud.Sdk.Api.ConvertApi(configurations);
             
// załaduj plik HTML z dysku lokalnego             
using (var stream = System.IO.File.OpenRead("converted.html"))
{
    // utwórz instancję FileApi
    var fileUpload = new FileApi(configurations);
    // prześlij wejściowy plik HTML do magazynu w chmurze
    fileUpload.UploadFile(new UploadFileRequest("input.html", stream));

    // utwórz ConvertSettings, w którym definiujemy wejściowy kod HTML i nazwę wynikowego pliku PDF
    var settings = new ConvertSettings
    {
        StorageName = "internal",
        FilePath = "input.html",
        Format = "pdf",
        OutputPath = "resultant.pdf"
    };
    
    // Wywołaj metodę ConvertDocument, aby programowo przekonwertować HTML na PDF.
    var response = apiInstance.ConvertDocument(new GroupDocs.Conversion.Cloud.Sdk.Model.Requests.ConvertDocumentRequest(settings));
    if (response != null && response.Equals("OK"))
    {
        // wydrukuj wiadomość o powodzeniu
        Console.WriteLine("HTMl to PDF conversion completed successfully !");
    }
}
Podgląd konwersji HTML do PDF.

Obraz: – Podgląd konwersji HTML do PDF.

Przykładowy plik PDF wygenerowany w powyższym przykładzie można pobrać z resultant.pdf.

HTML do PDF przy użyciu poleceń cURL

Inną opcją konwersji HTML na PDF jest połączenie poleceń GroupDocs.Conversion Cloud i cURL. Konwersja HTML na PDF za pomocą GroupDocs.Conversion Cloud za pomocą poleceń cURL oferuje kilka znaczących korzyści, takich jak zapewnia bezproblemową i prostą metodę konwersji plików HTML do formatu PDF, eliminując potrzebę wykonywania skomplikowanych procesów ręcznych. Dlatego też, wykorzystując API GroupDocs.Conversion Cloud, użytkownicy mogą zautomatyzować proces konwersji, oszczędzając czas i wysiłek w przypadku powtarzalnych zadań.

Upewnij się, że uzyskałeś poświadczenia API (klucz aplikacji i identyfikator SID aplikacji) z panelu GroupDocs i wygeneruj token dostępu JWT. Gdy już będziemy mieli token JWT, wykonaj następujące polecenie cURL, w którym udostępniliśmy również właściwości tekstowego znaku wodnego, który ma zostać dodany podczas procesu konwersji.

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

Proszę zamienić sourceFile na nazwę wejściowego pliku HTML, resultantFile na nazwę wyjściowego formatu PDF, który ma zostać wygenerowany, a accessToken na token JWT wygenerowany powyżej.

Bezpłatna aplikacja do konwersji HTML na PDF

W oparciu o API GroupDocs.Conversion Cloud opracowaliśmy online konwerter HTML na PDF. Jest darmowy, lekki, superwydajny i zapewnia solidną konwersję HTML do PDF.

bezpłatna aplikacja HTML do PDF

Przydatne linki

Wniosek

Dowiedzieliśmy się, że GroupDocs.Conversion Cloud oferuje bezproblemowe, wydajne i niezawodne rozwiązanie do zadań konwersji dokumentów, umożliwiające usprawnienie przepływu pracy i zwiększenie produktywności. Automatyzując proces konwersji oraz zapewniając spójność i dokładność wyników, GroupDocs.Conversion Cloud API upraszcza złożone zadania i oszczędza cenny czas i zasoby. Dlatego niezależnie od tego, czy jesteś programistą chcącym zintegrować możliwości konwersji dokumentów ze swoimi aplikacjami, czy też firmą pragnącą zoptymalizować procesy zarządzania dokumentami, nasze interfejsy API zapewniają narzędzia potrzebne do osiągnięcia sukcesu.

Powiązane artykuły

Zdecydowanie zalecamy odwiedzenie poniższych łączy, aby dowiedzieć się więcej na temat: