O arquivo HTML é amplamente usado na internet para compartilhamento de informações. Como ele é suportado pela maioria das plataformas e quase todos os navegadores da web são capazes de carregar esse formato, ele o torna um dos formatos aceitáveis. No entanto, devido à sua ampla aceitação, muitos hackers tentam incorporar scripts maliciosos dentro de arquivos HTML. Os ataques de alto perfil de código HTML e JavaScript maliciosos tiveram um aumento dramático na conscientização e exploração nos últimos anos. Por outro lado, um arquivo XPS representa arquivos de layout de página que são baseados em XML Paper Specifications.
- XPS é semelhante ao formato de arquivo PDF, mas usa XML no layout, na aparência e nas informações de impressão de um documento.
API de conversão HTML
Aspose.HTML Cloud é projetado especificamente para fornecer os recursos para processar arquivos HTML. Além do HTML de entrada, também podemos carregar XHTML, MHTML, EPUB, Markdown ou uma página da Web por sua URL. A saída resultante pode ser PDF, XPS, DOCX ou formatos de imagem raster: JPEG, PNG, TIFF, BMP, GIF. Como a API é desenvolvida de acordo com a arquitetura REST, ela pode ser usada em aplicativos Desktop, Mobile, Web e Hybrid, bem como em plataformas desktop ou móveis.
Para facilitar ainda mais nossos clientes, criamos SDKs específicos para linguagens de programação. Os Cloud SDKs são wrappers em torno de REST APIs em várias linguagens de programação, permitindo que você processe documentos na linguagem de sua escolha. Dessa forma, você pode obter todos os benefícios de tipos fortes e destaques de IDE de forma rápida e fácil. Verifique o repositório GitHub Aspose.HTML para SDKs junto com exemplos funcionais, para você começar rapidamente. Neste artigo, discutiremos os recursos de conversão de documentos do Aspose.HTML Cloud SDK para .NET.
Instalação
Para começar a usar o Cloud SDK, o primeiro passo é instalá-lo no sistema. O SDK está disponível no NuGet e no GitHub. Execute o seguinte comando na janela do terminal para executar a instalação do NuGet
nuget install Aspose.HTML-Cloud
Outra opção é instalar o SDK por meio do Package Manager Console dentro do Visual Studio. Execute o seguinte comando:
PM> Install-Package Aspose.HTML-Cloud
Gerenciador de Pacotes NuGet
Outra abordagem mais fácil é instalar o SDK por meio do Gerenciador de Pacotes NuGet no Visual Studio IDE.
- Abra o Solution Explorer.
- Expanda o projeto e clique com o botão direito do mouse na pasta Pacotes dentro da sua solução.
- Selecione a opção Gerenciar pacotes NuGet…
- Clique na aba Navegar e procure por “Aspose.HTML-Cloud“.
- Clique no pacote Aspose.HTML-Cloud, selecione a versão apropriada na aba direita e clique no botão Adicionar pacote.
Assinatura gratuita na nuvem
O próximo passo importante é uma assinatura de conta gratuita no painel Aspose.Cloud. Nenhum cartão de crédito ou outros detalhes de pagamento são necessários. Se você tiver uma conta GitHub ou Google, basta se inscrever ou clicar no botão criar uma nova conta e fornecer as informações necessárias. Agora faça login no painel usando credenciais e expanda a seção Applications do painel e role para baixo em direção à seção Client Credentials para ver os detalhes do Client ID e do Client Secret.
HTML para XPS em C#
Nesta seção, discutiremos a conversão de arquivos HTML para o formato XPS nos dois cenários a seguir.
Carregar HTML do Cloud Storage
Siga as instruções abaixo para enviar um arquivo HTML para o armazenamento em nuvem e depois realizar a conversão para o formato XPS.
- Primeiro, crie uma instância HtmlApi passando os detalhes ClientID e ClientSecret como argumentos.
- Em segundo lugar, leia o arquivo HTML usando o método File.OpenRead(…).
- Terceiro, crie uma instância de StorageApi e use o método UploadFile(…) para carregar o arquivo HTML no armazenamento em nuvem.
- Por fim, chame o método PutConvertDocumentToXps(…) para realizar a conversão de HTML para XPS e salvar o XPS resultante no armazenamento em nuvem.
// Obter ClientID de https://dashboard.aspose.cloud/
string clientSecret = "d757548a9f2558c39c2feebdf85b4c44";
string clientID = "4db2f826-bf9c-42e7-8b2a-8cbca2d15553";
// sequência de URL base
const string SERVICE_API_HOST = "https://api.aspose.cloud";
// Criar instância 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.
// nome do arquivo resultante
string resultantFile = "Resultant.xps";
try
{
// carregue o arquivo da unidade local
using (var file = System.IO.File.OpenRead(@"C:\Users\shahbnay\Desktop\" + name))
{
// Criar instância StorageApi
var uploadFileRequest = new StorageApi(clientID, clientSecret, SERVICE_API_HOST);
// carregar arquivo HTML para armazenamento em nuvem
uploadFileRequest.UploadFile(file, "inputHTML.html");
}
// Realizar a conversão para o formato PDF
// salvar a saída no armazenamento em nuvem
AsposeResponse response = htmlApi.PutConvertDocumentToPdf(
name, resultantFile, width, height,
leftMargin, rightMargin, topMargin, bottomMargin);
// imprimir mensagem de sucesso se a conversão for bem-sucedida
if (response != null && response.Equals("OK"))
{
Console.WriteLine("HTML successfully converted to XPS !");
}
}catch (Exception ex)
{
Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}
Para fins de teste, o HTML de entrada e o XPS resultante podem ser baixados de inputHTML.html e Resultant.xps.
Converter HTML para XPS usando cURL
Como nossas APIs são desenvolvidas de acordo com a arquitetura REST, elas também podem ser acessadas por meio de comandos cURL. Nesta seção, discutiremos a conversão da página HTML para o formato XPS usando o comando cURL. Mas antes de prosseguirmos, o primeiro passo é criar o JSON Web Token (JWT) com base nas credenciais do cliente do painel Aspose.Cloud. Siga as etapas fornecidas abaixo para executar a conversão de HTML para XPS.
- Obtenha seu ID do cliente e seu segredo do cliente no painel do Cloud.
- Obtenha o JSON Web Access Token com base nas credenciais do cliente.
- Chame a API PutConvertDocumentToXps.
- O arquivo PDF resultante será salvo no armazenamento em nuvem.
Execute o seguinte comando cURL para gerar o token de acesso 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"
Execute o seguinte comando para enviar os arquivos HTML para o armazenamento em nuvem:
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":{}}
Após o HTML ser carregado no armazenamento em nuvem, o comando a seguir pode ser usado para executar a conversão de HTML para XPS e salvar o arquivo resultante no armazenamento em nuvem.
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>"
Visualizador XPS gratuito
Para visualizar o arquivo XPS, você pode considerar usar o XPS Viewer App. Ele é desenvolvido em cima de APIs REST e permite que você experimente os incríveis recursos da API.
Conclusão
Exploramos os recursos do Aspose.HTML Cloud para a conversão de arquivos HTML para layout de página fixo e outras imagens raster. Exploramos os recursos para converter HTML usando o snippet de código C# .NET, bem como usando os comandos cURL.
No entanto, Aspose.HTML Cloud SDK para .NET que é um wrapper em torno do Aspose.HTML Cloud é desenvolvido sob licença MIT, então o snippet de código completo pode ser baixado do GitHub. Se você encontrar algum problema ao usar a API, sinta-se à vontade para entrar em contato conosco através do fórum de suporte gratuito ao produto.
Artigos relacionados
Recomendamos visitar os seguintes links para saber mais sobre