Converta HTML para PDF em C# usando a API REST

Converta HTML para PDF em C# usando a API REST

Os arquivos HTML são amplamente usados na Internet. A conversão de HTML para PDF é útil para visualização, leitura de documentos off-line, impressão ou compartilhamento de arquivos PDF convertidos em formato protegido. Em vários cenários, você precisa converter páginas da Web ou arquivos HTML em documentos PDF programaticamente em seus aplicativos .NET. Portanto, neste artigo, discutiremos as etapas de como converter HTML em PDF em C# usando a API REST.

Os seguintes tópicos serão discutidos neste artigo:

HTML to PDF C# Converter API - Download gratuito

Para converter página da Web HTML em arquivo PDF ou para conversão em lote de arquivos HTML em PDF, usarei .NET SDK do GroupDocs.Conversion Cloud API. A razão pela qual estamos discutindo este arquivo HTML para a biblioteca C# do conversor de arquivo PDF aqui é que é uma solução de conversão de arquivo poderosa, eficiente e de alto desempenho. Ele fornece conversão de alta qualidade de mais de 50 tipos de documentos e imagens, incluindo todo o MS Office, PDF, HTML, CAD, imagens raster e muito mais. Ele converte uma lista de formatos de documento de origem suportados em qualquer outro formato de arquivo suportado. Atualmente, ele fornece SDKs C#, Java, PHP, Ruby, Python e Node.js como seus membros da família de conversão de documentos para a Cloud API.

Você pode instalar o GroupDocs.Conversion .Net SDK em seu projeto do Visual Studio a partir do NuGet Package manager ou usando o seguinte comando no .Net CLI:

dotnet add package GroupDocs.Conversion-Cloud --version 22.10.0

Após a instalação, você precisa obter seu Client ID e Client Secret no dashboard antes de começar a seguir as etapas e os exemplos de código disponíveis. Adicione seu Client ID e Client Secret no código conforme mostrado abaixo:

//Obtenha clientId e clientSecret em https://dashboard.groupdocs.cloud (é necessário registro gratuito).
string clientId = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
string clientSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
string myStorage = "test-internal-storage";

var configuration = new Configuration(clientId, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

Como converter HTML para PDF em C# usando a API REST

Nesta seção, discutiremos os detalhes de como converter uma página HTML em um arquivo PDF em C# usando a API REST seguindo as etapas simples abaixo:

  • Upload o documento HTML para a nuvem
  • Converter HTML para PDF usando a API C# REST
  • Baixar o arquivo convertido

Carregue o Documento

Em primeiro lugar, carregue o documento HTML para o armazenamento em nuvem usando qualquer um dos seguintes métodos:

  • Usando o painel
  • Carregar arquivo de origem usando Upload File API do navegador
  • Carregar programaticamente usando o exemplo de código fornecido abaixo
using System;
using GroupDocs.Conversion.Cloud.Sdk.Api;
using GroupDocs.Conversion.Cloud.Sdk.Client;
using GroupDocs.Conversion.Cloud.Sdk.Model.Requests;
using System.IO;

namespace GroupDocs.Conversion.CSharp
{
  // Carregar arquivo de amostra
  class Upload_File
  {
    static void Main(string[] args)
    {
      try
      {
        // inicializar API
        var fileApi = new FileApi(configuration);

        // abrir arquivo
        var fileStream = File.Open(@"H:\groupdocs-cloud-data\input-sample-file.html", FileMode.Open);

        // criar solicitação de upload de arquivo
        var request = new UploadFileRequest("csharp-testing/input-sample-file.html", fileStream, myStorage);

        // subir arquivo
        var response = fileApi.UploadFile(request);
        Console.WriteLine("HTML File Upload Process Completed: " + response.Uploaded.Count.ToString());
        fileStream.Close();
      }
      catch (Exception e)
      {
        Console.WriteLine("Exception when calling GroupDocs FileApi: " + e.Message);
      }
    }
  }
}

Como resultado, o arquivo HTML de origem será carregado no Cloud Storage.

Converter Arquivo HTML para PDF Online

Esta seção demonstra como converter HTML em PDF online em C# programaticamente usando a API REST. Siga os passos mencionados abaixo:

  • Em primeiro lugar, crie uma instância do ConvertApi
  • Em segundo lugar, crie uma instância do ConvertSettings
  • Em terceiro lugar, forneça o caminho do arquivo HTML de entrada
  • Em seguida, atribua “pdf” ao formato
  • Em seguida, forneça o caminho do arquivo de saída
  • Agora, crie ConvertDocumentRequest com ConvertSettings
  • Finalmente, converta chamando o método convertDocument() com ConvertDocumentRequest

O exemplo de código a seguir mostra como converter um documento HTML em um documento PDF em C# usando a API REST:

// Como converter HTML para PDF em C# usando a API REST
using System;
using GroupDocs.Conversion.Cloud.Sdk.Api;
using GroupDocs.Conversion.Cloud.Sdk.Client;
using GroupDocs.Conversion.Cloud.Sdk.Model;
using GroupDocs.Conversion.Cloud.Sdk.Model.Requests;

namespace GroupDocs.Conversion.CSharp
{
  // Alterar HTML para arquivo PDF on-line
  class Convert_HTML_to_PDF
  {
    static void Main(string[] args)
    {
      try
      {
        // Crie instâncias de API necessárias
        var apiInstance = new ConvertApi(configuration);
        // Preparar configurações de conversão
        var settings = new ConvertSettings
        {
          FilePath = "csharp-testing/input-sample-file.html",
          Format = "pdf",
          OutputPath = "csharp-testing/output-sample-file.pdf"
        };
        
        // Converter para o formato especificado
        var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
        Console.WriteLine("Successfully converted HTML to PDF format online in C#: " + response[0].Url);
      }
      catch (Exception e)
      {
        Console.WriteLine("Exception when calling GroupDocs ConvertApi: " + e.Message);
      }
    }
  }
}

Documento PDF convertido

Como converter arquivo HTML para PDF online em C#

Converter Arquivo HTML para PDF Online

Baixe o arquivo convertido

É assim que você pode converter um arquivo HTML em PDF. Em seguida, baixe o arquivo PDF convertido da nuvem usando o seguinte trecho de código:

// Como baixar arquivo HTML convertido em C#
using System;
using GroupDocs.Conversion.Cloud.Sdk.Api;
using GroupDocs.Conversion.Cloud.Sdk.Client;
using GroupDocs.Conversion.Cloud.Sdk.Model.Requests;

namespace GroupDocs.Conversion.CSharp
{
  // Baixar arquivo de saída
  class Download_File
  {
    static void Main(string[] args)
    {
      try
      {
        // inicializar API
        var fileApi = new FileApi(configuration);
        // criar solicitação de download de arquivo
        var downloadRequest = new DownloadFileRequest("csharp-testing/output-sample-file.pdf", myStorage);
        // ⇬ Fazer download do arquivo
        Stream downloadResponse = fileApi.DownloadFile(downloadRequest);

        // salvar arquivo no diretório de trabalho
        using (var fileStream = System.IO.File.Create("H:\\groupdocs-cloud-data\\output-sample-file.pdf"))
        {
          downloadResponse.Seek(0, SeekOrigin.Begin);
          downloadResponse.CopyTo(fileStream);
        }
      }
      catch (Exception e)
      {
        Console.WriteLine("Exception when calling GroupDocs FileApi: " + e.Message);
      }

    }
  }
}

Converter HTML para PDF em C# usando opções avançadas

O SDK .NET permite converter arquivos HTML em documentos PDF criptografados. Converta a página da Web HTML em arquivo PDF com algumas configurações avançadas seguindo as etapas abaixo:

  • Em primeiro lugar, crie uma instância do ConvertApi
  • Em segundo lugar, crie uma instância do ConvertSettings
  • Em terceiro lugar, forneça o caminho do arquivo html de entrada
  • Em seguida, atribua “pdf” ao formato
  • Em seguida, crie uma instância do PdfConvertOptions
  • Você pode, opcionalmente, definir várias opções de conversão, como CenterWindow, FromPage, margens (superior, esquerda, direita, inferior), etc.
  • Em seguida, forneça o caminho do arquivo de saída
  • Em seguida, crie ConvertDocumentRequest com ConvertSettings
  • Por fim, converta o arquivo HTML em documento PDF chamando o método convertDocument() com ConvertDocumentRequest

O exemplo de código a seguir mostra como salvar uma página HTML como PDF online com configurações avançadas:

// Como converter HTML para PDF em C# usando opções avançadas
using System;
using GroupDocs.Conversion.Cloud.Sdk.Api;
using GroupDocs.Conversion.Cloud.Sdk.Client;
using GroupDocs.Conversion.Cloud.Sdk.Model;
using GroupDocs.Conversion.Cloud.Sdk.Model.Requests;

namespace GroupDocs.Conversion.CSharp
{
  // Alterar HTML para arquivo PDF on-line
  class Convert_HTML_to_PDF
  {
    static void Main(string[] args)
    {
      try
      {
        // Crie instâncias de API necessárias
        var apiInstance = new ConvertApi(configuration);
        // Preparar configurações de conversão
        var settings = new ConvertSettings
        {
          FilePath = "csharp-testing/input-sample-file.html",
          Format = "pdf",
          ConvertOptions = new PdfConvertOptions
          {
              CenterWindow = true,
              CompressImages = false,
              DisplayDocTitle = true,
              Dpi = 1024,
              FitWindow = false,
              FromPage = 1,
              Grayscale = false,
              ImageQuality = 100,
              Linearize = false,
              MarginTop = 5,
              MarginLeft = 5,
              Password = "password",
              UnembedFonts = true,
              RemoveUnusedStreams = true,
              RemoveUnusedObjects = true,
              RemovePdfaCompliance = false
          },
          OutputPath = "csharp-testing/output-sample-file.pdf"
        };
        
        // Converter para o formato especificado
        var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
        Console.WriteLine("Successfully converted HTML to PDF online using C#: " + response[0].Url);
      }
      catch (Exception e)
      {
        Console.WriteLine("Exception when calling GroupDocs ConvertApi: " + e.Message);
      }
    }
  }
}

Isto é como salvar HTML como PDF. Siga as etapas mencionadas anteriormente para fazer upload e download de um arquivo.

Saída

Como converter arquivo HTML para PDF em C# usando opções avançadas

Converter HTML para PDF em C# usando opções avançadas

Conversor de HTML para PDF Online Gratuito

Como converter HTML para PDF online grátis? Tente o seguinte conversor de HTML para PDF on-line gratuito para converter arquivo HTML em PDF on-line gratuitamente, desenvolvido usando a API acima.

Conclusão

Neste artigo, exploramos as etapas de:

  • como alterar HTML para PDF online em C# na nuvem;
  • carregue programaticamente a página da Web html e, em seguida, baixe o arquivo PDF convertido da nuvem;
  • converta online HTML para PDF sem perder a formatação em C# usando opções avançadas;
  • Conversor de HTML para PDF online grátis;

Você pode aprender mais sobre GroupDocs.Conversion Cloud API usando a documentação. Também fornecemos uma seção Referência de API que permite visualizar e interagir com nossas APIs diretamente pelo navegador. Se você estiver interessado em fazer alterações no código-fonte do C# Cloud SDK, ele pode ser baixado do GitHub.

Finalmente, groupdocs.com está escrevendo novos artigos de blog. Então, por favor, fique em contato para atualizações regulares.

Faça uma pergunta

Caso encontre algum problema ao usar a biblioteca do conversor de HTML para PDF, sinta-se à vontade para nos contatar através do nosso Fórum de suporte gratuito.

perguntas frequentes

Como converter páginas HTML em arquivos PDF?

Siga este link para aprender o trecho de código C# sobre como salvar o arquivo HTML como PDF de forma rápida e fácil.

Como baixar o SDK do conversor de HTML para PDF?

Instale o conversor de arquivo HTML para PDF download gratuito da biblioteca C# para criar, baixar e processar a conversão de HTML para PDF programaticamente.

Qual é o melhor conversor online de HTML para PDF grátis?

O conversor online de HTML para PDF permite que você converta uma ou várias páginas HTML em documentos PDF gratuitamente. Converta HTML para PDF online gratuitamente usando HTML online para PDF conversor rapidamente, em segundos.

Como faço para converter HTML para PDF online grátis?

  • Abra nosso conversor de HTML para PDF online grátis
  • Clique dentro da área para soltar o arquivo para carregar o arquivo HTML ou arraste e solte o arquivo HTML.
  • Clique no botão Converter agora. Sua página da Web em HTML será carregada e convertida em formato de arquivo PDF.
  • O link de download dos arquivos de saída estará disponível instantaneamente após a conversão.

Como converter HTML para PDF no Windows 10 grátis?

Visite este link para baixar o software conversor de HTML para PDF gratuitamente. Este software conversor de documentos gratuito converterá arquivos HTML em PDF no Windows 10 com um único clique.

Veja também

Também recomendamos visitar os links a seguir para obter ajuda e suporte adicionais: