Convertir HTML en PDF en C# .NET

La demande de solutions efficaces de gestion de documents continue de croître de façon exponentielle. Dans cet article, nous examinons les avantages et les applications pratiques de l’utilisation de l’API .NET Cloud pour la conversion HTML vers PDF. De la rationalisation des flux de travail à la garantie de la compatibilité entre diverses plates-formes, découvrez comment cette fonctionnalité peut améliorer considérablement la productivité et simplifier les tâches de gestion documentaire.

Cet article couvre les sujets suivants :

API de conversion HTML en PDF

Nous allons explorer les capacités robustes du SDK GroupDocs.Conversion Cloud pour .NET et son rôle central dans la réalisation transparente des exigences de conversion HTML en PDF. Alors que les entreprises et les développeurs recherchent des solutions efficaces pour la gestion documentaire, cette API apparaît comme un outil puissant, offrant une simplicité et une polyvalence inégalées. Voyons comment ce SDK de conversion vous permet de convertir sans effort des fichiers HTML au format PDF, facilitant ainsi des flux de travail plus fluides et une productivité améliorée.

Désormais, pour utiliser le SDK, la première étape est son installation. Recherchez simplement GroupDocs.Conversion-Cloud dans le gestionnaire de packages NuGet et cliquez sur le bouton Installer. Une autre option consiste à exécuter la commande suivante dans la console du gestionnaire de packages.

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

Une fois l’API REST installée avec succès, assurez-vous que vous disposez des informations d’identification de l’API (c’est-à-dire l’ID client et le secret client).Vous pouvez visiter ce court tutoriel pour voir comment obtenir les informations d’identification de l’API.

Convertir du HTML en PDF à l’aide de C# .NET

Dans cette section, nous allons explorer les détails sur la façon de convertir du HTML en PDF par programme à l’aide de C# .NET.

  1. Créez une instance de la classe « Configuration » où nous transmettons les informations d’identification du client comme arguments.
var configurations = new Configuration(clientId, clientSecret1);
  1. Initialisez le ConvertApi où nous passons l’objet Configuration comme argument d’entrée.
var apiInstance = new ConvertApi(configurations);
  1. Téléchargez le fichier HTML d’entrée sur le stockage cloud, où nous fournissons le nom du fichier HTML d’entrée.
fileUpload.UploadFile(new UploadFileRequest("input.html", stream));
  1. Créez une instance « ConvertSettings » dans laquelle nous spécifions le nom du HTML d’entrée, le format de sortie comme « pdf » et le nom du document PDF résultant.
var settings = new ConvertSettings{...}
  1. Appelez l’API ConvertDocumentRequest pour convertir le HTML au format PDF. Une fois la conversion réussie, le PDF résultant est stocké dans le stockage cloud.
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
// Plus d'exemples sur https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// Obtenez vos identifiants API 
string clientId = "4bdefca3-f08c-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "a43c8b4365246a062688a259abe5b469";

// Créez une instance de la classe Configuration et initialisez-la avec l'ID client et le secret client. 
var configurations = new GroupDocs.Conversion.Cloud.Sdk.Client.Configuration(clientId, clientSecret1);
// Définissez la valeur de ApiBaseUrl pour définir l'URL de base de l'API du convertisseur HTML en PDF.
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

// Initialisez une instance de la classe ConvertApi avec l'objet de la classe Configuration.
var apiInstance = new GroupDocs.Conversion.Cloud.Sdk.Api.ConvertApi(configurations);
             
// charger le fichier HTML à partir du lecteur local             
using (var stream = System.IO.File.OpenRead("converted.html"))
{
    // créer une instance de FileApi
    var fileUpload = new FileApi(configurations);
    // télécharger le fichier HTML d'entrée sur le stockage cloud
    fileUpload.UploadFile(new UploadFileRequest("input.html", stream));

    // créer ConvertSettings où nous définissons le code HTML d'entrée et le nom du PDF résultant
    var settings = new ConvertSettings
    {
        StorageName = "internal",
        FilePath = "input.html",
        Format = "pdf",
        OutputPath = "resultant.pdf"
    };
    
    // Appelez la méthode ConvertDocument pour convertir le HTML en PDF par programmation.
    var response = apiInstance.ConvertDocument(new GroupDocs.Conversion.Cloud.Sdk.Model.Requests.ConvertDocumentRequest(settings));
    if (response != null && response.Equals("OK"))
    {
        // imprimer le message de réussite
        Console.WriteLine("HTMl to PDF conversion completed successfully !");
    }
}
Un aperçu de la conversion HTML en PDF.

Image : - Un aperçu de la conversion HTML en PDF.

L’exemple de PDF généré dans l’exemple ci-dessus peut être téléchargé à partir de resultant.pdf.

HTML vers PDF à l’aide des commandes cURL

Une autre option pour convertir du HTML en PDF est une combinaison de commandes GroupDocs.Conversion Cloud et cURL. La conversion de HTML en PDF à l’aide de GroupDocs.Conversion Cloud via les commandes cURL offre plusieurs avantages notables, tels qu’une méthode transparente et simple pour convertir des fichiers HTML au format PDF, éliminant ainsi le besoin de processus manuels complexes. Par conséquent, en tirant parti de l’API GroupDocs.Conversion Cloud, les utilisateurs peuvent automatiser le processus de conversion, économisant ainsi du temps et des efforts sur les tâches répétitives.

Assurez-vous d’avoir obtenu vos informations d’identification API (App Key et App SID) à partir du tableau de bord GroupDocs et générez un jeton d’accès JWT. Une fois que nous avons le jeton JWT, veuillez exécuter la commande cURL suivante, dans laquelle nous avons également fourni des propriétés pour le filigrane de texte à ajouter pendant ce processus de conversion.

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}\"}"

Veuillez remplacer sourceFile par le nom du fichier HTML d’entrée, resultantFile par le nom du format PDF de sortie à générer et accessToken par le jeton JWT généré ci-dessus.

Application gratuite de conversion HTML en PDF

Sur la base de l’API GroupDocs.Conversion Cloud, nous avons développé en ligne HTML to PDF Converter. Il s’agit d’un outil gratuit, léger, super efficace et qui fournit une conversion HTML en PDF robuste.

application gratuite HTML vers PDF

Liens utiles

Conclusion

Nous avons appris que GroupDocs.Conversion Cloud offre une solution transparente, efficace et fiable pour les tâches de conversion de documents, vous permettant de rationaliser vos flux de travail et d’améliorer votre productivité. Ainsi, en automatisant le processus de conversion et en garantissant la cohérence et l’exactitude des résultats, l’API GroupDocs.Conversion Cloud simplifie les tâches complexes et permet d’économiser un temps et des ressources précieux. Par conséquent, que vous soyez un développeur cherchant à intégrer des fonctionnalités de conversion de documents dans vos applications ou une entreprise cherchant à optimiser vos processus de gestion de documents, nos API fournissent les outils dont vous avez besoin pour réussir.

Articles Liés

Nous vous recommandons fortement de visiter les liens suivants pour en savoir plus sur :