Tutorial para criar um arquivo PDF com Blazor

Criando um novo projeto no Visual Studio

Para começar, abra o aplicativo Microsoft Visual Studio e selecione "Novo Projeto" no menu Arquivo. Em seguida, selecione "Aplicativo de servidor Blazor ".

Criando um novo projeto no Visual Studio

Insira o nome do projeto e selecione o caminho do arquivo. Em seguida, clique no botão Criar .

Escolher o nome e a localização da nova aplicação Blazor.

Selecione a .NET Framework desejada (neste tutorial, usaremos o .NET 6.0), conforme mostrado na captura de tela abaixo:

Criando um novo projeto no Visual Studio com o .NET Framework 6.0

O Microsoft Visual Studio irá agora gerar a estrutura para esta aplicação Blazor .

Em seguida, adicione a biblioteca IronPDF a este novo projeto.

3.1 Usando o Gerenciador de Pacotes NuGet do Visual Studio

O Visual Studio fornece o Gerenciador de Pacotes NuGet para auxiliar na instalação de bibliotecas diretamente nos projetos. A captura de tela abaixo mostra como abrir o Gerenciador de Pacotes NuGet .

Acessando o Gerenciador de Pacotes NuGet do Visual Studio

Utilize o campo de pesquisa na aba Procurar para buscar por "IronPDF", como mostrado na captura de tela abaixo:

Procurando a biblioteca IronPDF na interface gráfica do Gerenciador de Pacotes NuGet.

Na imagem acima, é apresentada a lista de resultados de pesquisa relacionados. Selecione as opções necessárias para instalar o pacote em seu projeto.

3.2 Usando a linha de comando do Visual Studio

No Visual Studio, acesse Ferramentas > Gerenciador de Pacotes NuGet > Console do Gerenciador de Pacotes.

Insira a seguinte linha na guia Console do Gerenciador de Pacotes:

Install-Package IronPdf

O pacote será baixado e instalado no projeto atual.

Instalando a biblioteca IronPDF usando o Console do Gerenciador de Pacotes NuGet

3.3 Baixando diretamente do site do NuGet

A terceira maneira de instalar a biblioteca IronPDF é baixar o pacote NuGet diretamente do site.

Acesse o site do NuGet para o IronPDF .

• Clique na opção "Baixar pacote" no menu à direita.
• Abra o pacote baixado no seu sistema de arquivos. Será instalado automaticamente.
• Recarregue a solução e comece a usá-la em seu projeto.

3.4 Download direto do site do IronPDF

Acesse o site do IronPDF para baixar o pacote IronPDF diretamente.

Após o download, siga estes passos para adicionar o pacote ao seu projeto:

• Clique com o botão direito do mouse no projeto na janela de soluções.
• Selecione a opção "Adicionar" > "Referência" e navegue até o local da biblioteca que você baixou anteriormente.
• Clique em OK para adicionar a biblioteca como referência.

4. Criar documentos PDF no aplicativo Blazor Server

O aplicativo Blazor deste tutorial usará o IronPDF para obter o conteúdo HTML de uma página da web a partir de seu URL e convertê-lo em um documento PDF.

Insira o seguinte código-fonte no arquivo Razor contido no projeto.

@using IronPdf

@code {
    /// <summary>
    /// This method exports data by converting a URL to a PDF file and initiating its download.
    /// </summary>
    public async Task ExportData()
    {
        try
        {
            string fileName = "Demo.pdf";
            var renderer = new ChromePdfRenderer();

            // Render the contents of the URL as a PDF document
            var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");

            // Save the PDF using a JavaScript function
            await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()));
        }
        catch (Exception ex)
        {
            // Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}");
        }
    }
}

@using IronPdf

@code {
    /// <summary>
    /// This method exports data by converting a URL to a PDF file and initiating its download.
    /// </summary>
    public async Task ExportData()
    {
        try
        {
            string fileName = "Demo.pdf";
            var renderer = new ChromePdfRenderer();

            // Render the contents of the URL as a PDF document
            var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");

            // Save the PDF using a JavaScript function
            await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()));
        }
        catch (Exception ex)
        {
            // Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}");
        }
    }
}

[using] ReadOnly Property code() As IronPdf
	''' <summary>
	''' This method exports data by converting a URL to a PDF file and initiating its download.
	''' </summary>
'INSTANT VB TODO TASK: Local functions are not converted by Instant VB:
'	public async Task ExportData()
'	{
'		try
'		{
'			string fileName = "Demo.pdf";
'			var renderer = New ChromePdfRenderer();
'
'			' Render the contents of the URL as a PDF document
'			var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
'
'			' Save the PDF using a JavaScript function
'			await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()));
'		}
'		catch (Exception ex)
'		{
'			' Handle any exceptions that may occur
'			Console.@Error.WriteLine(string.Format("Error in ExportData: {0}", ex.Message));
'		}
'	}
End Property

O trecho de código acima utiliza dois métodos para gerar documentos PDF a partir de HTML. O primeiro é o método RenderUrlAsPdf do IronPDF, que baixa o conteúdo HTML de um URL fornecido e o converte em formato PDF.

O segundo método é o método estático JSRuntime.InvokeVoidAsync, que aciona o mecanismo JavaScript de um navegador para invocar uma função JavaScript dentro do escopo da página da web que salva o conteúdo do PDF em um arquivo no sistema de arquivos do cliente.

Essa função JavaScript está incluída abaixo:

<script type="text/javascript">
    /**
     * Saves the PDF data as a file on the client's system.
     * @param {string} filename - The name of the file to be created.
     * @param {string} bytesBase64 - The Base64 encoded string of the PDF data.
     */
    function saveAsFile(filename, bytesBase64) {
        if (navigator.msSaveBlob) {
            // Download the document in Microsoft Edge browser
            var data = window.atob(bytesBase64);
            var bytes = new Uint8Array(data.length);
            for (var i = 0; i < data.length; i++) {
                bytes[i] = data.charCodeAt(i);
            }
            var blob = new Blob([bytes.buffer], { type: "application/octet-stream" });
            navigator.msSaveBlob(blob, filename);
            window.navigator.msSaveOrOpenBlob(blob);
        }
        else {
            var link = document.createElement('a');
            link.download = filename;
            link.href = "data:application/octet-stream;base64," + bytesBase64;
            document.body.appendChild(link); // Needed for Firefox
            link.click();
            document.body.removeChild(link);
        }
    }
</script>

<script type="text/javascript">
    /**
     * Saves the PDF data as a file on the client's system.
     * @param {string} filename - The name of the file to be created.
     * @param {string} bytesBase64 - The Base64 encoded string of the PDF data.
     */
    function saveAsFile(filename, bytesBase64) {
        if (navigator.msSaveBlob) {
            // Download the document in Microsoft Edge browser
            var data = window.atob(bytesBase64);
            var bytes = new Uint8Array(data.length);
            for (var i = 0; i < data.length; i++) {
                bytes[i] = data.charCodeAt(i);
            }
            var blob = new Blob([bytes.buffer], { type: "application/octet-stream" });
            navigator.msSaveBlob(blob, filename);
            window.navigator.msSaveOrOpenBlob(blob);
        }
        else {
            var link = document.createElement('a');
            link.download = filename;
            link.href = "data:application/octet-stream;base64," + bytesBase64;
            document.body.appendChild(link); // Needed for Firefox
            link.click();
            document.body.removeChild(link);
        }
    }
</script>

A função JavaScript acima recebe os dados Base64 do Blazor e os converte em um blob antes de salvá-los no local do lado do cliente.

Alternativamente, o método SaveAs da classe ChromePdfRenderer também pode ser usado para salvar documentos PDF no armazenamento local do navegador.