Convertir HTML en XPS en C# .NET

html vers xps — Comment convertir HTML en XPS en C# .NET

Le fichier HTML est largement utilisé sur Internet pour le partage d’informations. Comme il est pris en charge par la majorité des plates-formes et que presque tous les navigateurs Web sont capables de charger ce format, il fait partie des formats acceptables. Cependant, en raison de sa large acceptation, de nombreux pirates informatiques tentent d’intégrer des scripts malveillants dans les fichiers HTML. Les attaques très médiatisées de codes HTML et JavaScript malveillants ont connu une augmentation spectaculaire de la sensibilisation et de l’exploitation ces dernières années. À l’autre extrémité, un fichier XPS représente des fichiers de mise en page basés sur les spécifications XML Paper.

XPS est similaire au format de fichier PDF mais utilise XML dans la mise en page, l’apparence et les informations d’impression d’un document.

API de conversion HTML
Conversion de HTML en XPS en C#
Convertir HTML en XPS avec cURL

API de conversion HTML

Aspose.HTML Cloud est spécialement conçu pour fournir les capacités de traitement des fichiers HTML. Outre le HTML d’entrée, nous pouvons également charger XHTML, MHTML, EPUB, Markdown ou une page Web par son URL. Le résultat peut être un PDF, XPS, DOCX ou des formats d’image raster : JPEG, PNG, TIFF, BMP, GIF. Comme l’API est développée selon l’architecture REST, elle peut être utilisée dans des applications de bureau, mobiles, Web et hybrides, ainsi que sur des plates-formes de bureau ou mobiles.

Afin de faciliter encore plus la tâche de nos clients, nous avons créé des SDK spécifiques aux langages de programmation. Les SDK Cloud sont des wrappers autour des API REST dans divers langages de programmation, vous permettant de traiter des documents dans le langage de votre choix. De cette façon, vous pouvez rapidement et facilement bénéficier de tous les avantages des types forts et des points forts de l’IDE. Veuillez consulter le référentiel GitHub Aspose.HTML pour les SDK ainsi que des exemples fonctionnels, pour vous aider à démarrer en un rien de temps. Dans cet article, nous allons discuter des fonctionnalités de conversion de documents du SDK Cloud Aspose.HTML for .NET.

Installation

Pour commencer à utiliser le SDK Cloud, la première étape consiste à l’installer sur le système. Le SDK est disponible sur NuGet et GitHub. Veuillez exécuter la commande suivante dans la fenêtre du terminal pour effectuer l’installation de NuGet

nuget install Aspose.HTML-Cloud

Une autre option consiste à installer le SDK via la console du gestionnaire de packages dans Visual Studio. Veuillez exécuter la commande suivante :

 PM> Install-Package Aspose.HTML-Cloud

Console du gestionnaire de paquets — Image 1 : Package NuGet Aspose.HTML installé.

Gestionnaire de paquets NuGet

Une autre approche la plus simple consiste à installer le SDK via le gestionnaire de packages NuGet dans Visual Studio IDE.

Ouvrez l’explorateur de solutions.
Développez le projet et cliquez avec le bouton droit sur le dossier Packages dans votre solution.
Sélectionnez l’option Gérer les packages NuGet…
Cliquez sur l’onglet Parcourir et recherchez « Aspose.HTML-Cloud ».
Cliquez sur le package Aspose.HTML-Cloud, sélectionnez la version appropriée dans l’onglet de droite et cliquez sur le bouton Ajouter un package.

légende — Image 2:- Aspose.HTML Package in NuGet Package Manager.

Abonnement Cloud gratuit

L’étape suivante importante est un abonnement gratuit à un compte sur tableau de bord Aspose.Cloud. Aucune carte de crédit ou autre information de paiement n’est requise. Si vous avez un compte GitHub ou Google, inscrivez-vous simplement ou cliquez sur le bouton créer un nouveau compte et fournissez les informations requises. Connectez-vous maintenant au tableau de bord à l’aide des informations d’identification et développez la section Applications du tableau de bord et faites défiler vers le bas jusqu’à la section Informations d’identification du client pour voir les détails de l’ID client et du secret client.

Informations d'identification du client — Image 3 : Informations d’identification du client sur le tableau de bord Aspose.Cloud.

Conversion de HTML en XPS en C#

Dans cette section, nous allons discuter de la conversion de fichiers HTML au format XPS pour les deux scénarios suivants.

Charger du code HTML à partir du stockage cloud

Veuillez suivre les instructions ci-dessous pour télécharger un fichier HTML sur le stockage Cloud, puis effectuer la conversion au format XPS.

Tout d’abord, veuillez créer une instance HtmlApi tout en transmettant les détails ClientID et ClientSecret comme arguments.
Deuxièmement, lisez le fichier HTML à l’aide de la méthode File.OpenRead(…).
Troisièmement, créez une instance de StorageApi et utilisez la méthode UploadFile(…) pour télécharger le fichier HTML vers le stockage Cloud.
Enfin, appelez la méthode PutConvertDocumentToXps(…) pour effectuer une conversion HTML en XPS et enregistrer le XPS résultant dans le stockage Cloud.

// Obtenez l'ID client à partir de https://dashboard.aspose.cloud/
string clientSecret = "d757548a9f2558c39c2feebdf85b4c44";
string clientID = "4db2f826-bf9c-42e7-8b2a-8cbca2d15553";
// chaîne d'URL de base
const string SERVICE_API_HOST = "https://api.aspose.cloud";

// Créer une instance HtmlApi
HtmlApi htmlApi = new HtmlApi(clientID, clientSecret,SERVICE_API_HOST);

String name = "inputHTML.html";// inpit Document name.
int width = 800; // Resulting image width.
int height = 1000; // Resulting image height.
int leftMargin = 10; // Left resulting image margin.
int rightMargin = 10; // Right resulting image margin.
int topMargin = 10; // Top resulting image margin.
int bottomMargin = 10; // Bottom resulting image margin.

// nom du fichier résultant
string resultantFile = "Resultant.xps";

try
{
    // charger le fichier à partir du lecteur local
    using (var file = System.IO.File.OpenRead(@"C:\Users\shahbnay\Desktop\" + name))
    {
        // Créer une instance StorageApi
        var uploadFileRequest = new StorageApi(clientID, clientSecret, SERVICE_API_HOST);
        
        // télécharger le fichier HTML vers le stockage Cloud
        uploadFileRequest.UploadFile(file, "inputHTML.html");
    }
    
    // Effectuer la conversion au format PDF
    // enregistrer la sortie sur le stockage Cloud
    AsposeResponse response = htmlApi.PutConvertDocumentToPdf(
    name, resultantFile, width, height,
    leftMargin, rightMargin, topMargin, bottomMargin);
    
    // imprimer un message de réussite si la conversion réussit
    if (response != null && response.Equals("OK"))
    {
        Console.WriteLine("HTML successfully converted to XPS !");
    }
}catch (Exception ex)
{
    Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}

À des fins de test, le code HTML d’entrée et le code XPS résultant peuvent être téléchargés à partir de inputHTML.html et Resultant.xps.

Convertir HTML en XPS avec cURL

Comme nos API sont développées selon l’architecture REST, elles sont également accessibles via les commandes cURL. Dans cette section, nous allons discuter de la conversion de la page HTML au format XPS à l’aide de la commande cURL. Mais avant de continuer, la première étape consiste à créer un jeton Web JSON (JWT) basé sur les informations d’identification du client à partir du tableau de bord Aspose.Cloud. Veuillez suivre les étapes ci-dessous pour effectuer la conversion HTML en XPS.

Obtenez votre identifiant client et votre secret client à partir du tableau de bord Cloud.
Obtenez un jeton d’accès Web JSON en fonction des informations d’identification du client.
Appelez l’API PutConvertDocumentToXps.
Le fichier PDF résultant sera enregistré dans le stockage Cloud.

Veuillez exécuter la commande cURL suivante pour générer le jeton d’accès JWT.

 curl -v "https://api.aspose.cloud/connect/token" \
 -X POST \
 -d "grant_type=client_credentials&client_id=4db2f826-bf9c-42e7-8b2a-8cbca2d15553&client_secret=d757548a9f2558c39c2feebdf85b4c44" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Accept: application/json"

Veuillez exécuter la commande suivante pour télécharger les fichiers HTML vers le stockage Cloud :

curl -X PUT "https://api.aspose.cloud/html/storage/file/inputHTML.html" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: multipart/form-data" \
-d {"File":{}}

Une fois le code HTML téléchargé sur le stockage Cloud, la commande suivante peut être utilisée pour effectuer la conversion HTML en XPS et enregistrer le fichier résultant dans le stockage Cloud.

curl -X PUT "https://api.aspose.cloud/html/inputHTML.html/convert/xps?outPath=converted.xps&width=800&height=1000&leftMargin=10&rightMargin=10&topMargin=10&bottomMargin=10" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"

Visionneuse XPS gratuite

Pour visualiser le fichier XPS, vous pouvez envisager d’utiliser XPS Viewer App. Il est développé sur la base des API REST et vous permet de découvrir les capacités étonnantes de l’API.

Conclusion

Nous avons exploré les capacités de Aspose.HTML Cloud pour la conversion de fichiers HTML en mise en page fixe et autres images raster. Nous avons exploré les fonctionnalités de conversion HTML à l’aide d’extraits de code C# .NET ainsi qu’à l’aide des commandes cURL.

Néanmoins, Aspose.HTML Cloud SDK for .NET qui est un wrapper autour d’Aspose.HTML Cloud est développé sous licence MIT, donc l’extrait de code complet peut être téléchargé depuis GitHub. Si vous rencontrez des problèmes lors de l’utilisation de l’API, n’hésitez pas à nous contacter via le forum d’assistance produit gratuit.

Articles connexes

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

API de conversion HTML#

Installation#

Gestionnaire de paquets NuGet#

Abonnement Cloud gratuit#

Conversion de HTML en XPS en C##

Charger du code HTML à partir du stockage cloud#

Convertir HTML en XPS avec cURL#

Visionneuse XPS gratuite#

Conclusion#

Articles connexes#