Converter HTML em PDF em C# .NET

A procura por soluções eficientes de gestão documental continua a crescer exponencialmente. Neste artigo, investigamos os benefícios e as aplicações práticas de aproveitar a API .NET Cloud para conversão de HTML em PDF. Desde a simplificação de fluxos de trabalho até a garantia de compatibilidade entre diversas plataformas, descubra como esse recurso pode aumentar significativamente a produtividade e simplificar as tarefas de gerenciamento de documentos.

Este artigo cobre os seguintes tópicos:

API de conversão de HTML para PDF

Exploraremos os recursos robustos do GroupDocs.Conversion Cloud SDK for .NET e seu papel fundamental no cumprimento perfeito do requisito de conversão de HTML para PDF. À medida que empresas e desenvolvedores buscam soluções eficientes para gerenciamento de documentos, esta API surge como uma ferramenta poderosa, oferecendo facilidade e versatilidade incomparáveis. Vamos nos aprofundar em como esse SDK de conversão permite que você converta facilmente arquivos HTML para o formato PDF, facilitando fluxos de trabalho mais suaves e aumentando a produtividade.

Agora, para utilizar o SDK, o primeiro passo é a sua instalação. Basta pesquisar GroupDocs.Conversion-Cloud no gerenciador de pacotes NuGet e clicar no botão Instalar. Outra opção é executar o seguinte comando no console do gerenciador de pacotes.

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

Depois que a API REST for instalada com êxito, certifique-se de ter as credenciais da API (ou seja, ID do cliente e segredo do cliente).Você pode visitar este breve tutorial para ver como obter as credenciais da API.

Converta HTML em PDF usando C# .NET

Nesta seção, exploraremos os detalhes sobre como converter HTML em PDF programaticamente usando C# .NET.

  1. Crie uma instância da classe Configuration onde passamos as credenciais do cliente como argumentos.
var configurations = new Configuration(clientId, clientSecret1);
  1. Inicialize o ConvertApi onde passamos o objeto Configuration como argumento de entrada.
var apiInstance = new ConvertApi(configurations);
  1. Carregue o arquivo HTML de entrada para armazenamento em nuvem, onde fornecemos o nome do arquivo HTML de entrada.
fileUpload.UploadFile(new UploadFileRequest("input.html", stream));
  1. Crie uma instância ConvertSettings onde especificamos o nome do HTML de entrada, o formato de saída como pdf e o nome do documento PDF resultante.
var settings = new ConvertSettings{...}
  1. Chame a API ConvertDocumentRequest para converter HTML para o formato PDF. Após a conversão bem-sucedida, o PDF resultante é armazenado em armazenamento em nuvem.
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));

// Mais exemplos em https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// Obtenha suas credenciais de API 
string clientId = "4bdefca3-f08c-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "a43c8b4365246a062688a259abe5b469";

// Crie uma instância da classe Configuration e inicialize-a com o Client ID e o Client Secret. 
var configurations = new GroupDocs.Conversion.Cloud.Sdk.Client.Configuration(clientId, clientSecret1);
// Defina o valor de ApiBaseUrl para definir o URL base da API do conversor de HTML para PDF.
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

// Inicialize uma instância da classe ConvertApi com o objeto da classe Configuration.
var apiInstance = new GroupDocs.Conversion.Cloud.Sdk.Api.ConvertApi(configurations);
             
// carregue o arquivo HTML da unidade local             
using (var stream = System.IO.File.OpenRead("converted.html"))
{
    // crie uma instância do FileApi
    var fileUpload = new FileApi(configurations);
    // carregue o arquivo HTML de entrada para armazenamento em nuvem
    fileUpload.UploadFile(new UploadFileRequest("input.html", stream));

    // crie ConvertSettings onde definimos o HTML de entrada e o nome do PDF resultante
    var settings = new ConvertSettings
    {
        StorageName = "internal",
        FilePath = "input.html",
        Format = "pdf",
        OutputPath = "resultant.pdf"
    };
    
    // Invoque o método ConvertDocument para converter HTML em PDF programaticamente.
    var response = apiInstance.ConvertDocument(new GroupDocs.Conversion.Cloud.Sdk.Model.Requests.ConvertDocumentRequest(settings));
    if (response != null && response.Equals("OK"))
    {
        // imprimir mensagem de sucesso
        Console.WriteLine("HTMl to PDF conversion completed successfully !");
    }
}
Uma prévia da conversão de HTML para PDF.

Imagem: – Uma prévia da conversão de HTML para PDF.

O PDF de amostra gerado no exemplo acima pode ser baixado em resultant.pdf.

HTML para PDF usando comandos cURL

Outra opção para converter HTML em PDF é uma combinação de comandos GroupDocs.Conversion Cloud e cURL. A conversão de HTML para PDF usando GroupDocs.Conversion Cloud por meio de comandos cURL oferece vários benefícios notáveis, como fornecer um método simples e direto para converter arquivos HTML para o formato PDF, eliminando a necessidade de processos manuais complexos. Portanto, ao aproveitar a API GroupDocs.Conversion Cloud, os usuários podem automatizar o processo de conversão, economizando tempo e esforço em tarefas repetitivas.

Certifique-se de ter obtido suas credenciais de API (chave de aplicativo e SID de aplicativo) no painel GroupDocs e gere o token de acesso JWT. Assim que tivermos o token JWT, execute o seguinte comando cURL, onde também fornecemos propriedades para marca d’água de texto a ser adicionada durante este processo de conversão.

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

Substitua sourceFile pelo nome do arquivo HTML de entrada, resultantFile pelo nome do formato PDF de saída a ser gerado e accessToken pelo token JWT gerado acima.

Aplicativo gratuito de conversão de HTML para PDF

Com base na API GroupDocs.Conversion Cloud, desenvolvemos online o Conversor HTML para PDF. É gratuito, leve, supereficiente e oferece uma conversão robusta de HTML para PDF.

aplicativo gratuito de html para pdf

Conclusão

Aprendemos que GroupDocs.Conversion Cloud oferece uma solução integrada, eficiente e confiável para tarefas de conversão de documentos, permitindo que você agilize seus fluxos de trabalho e aumente a produtividade. Assim, ao automatizar o processo de conversão e garantir consistência e precisão nos resultados, a GroupDocs.Conversion Cloud API simplifica tarefas complexas e economiza tempo e recursos valiosos. Portanto, seja você um desenvolvedor que busca integrar recursos de conversão de documentos em seus aplicativos ou uma empresa que busca otimizar seus processos de gerenciamento de documentos, nossas APIs fornecem as ferramentas que você precisa para ter sucesso.

Artigos relacionados

É altamente recomendável visitar os seguintes links para saber mais sobre: