Npgsql em C# (Como funciona para desenvolvedores)

1.1 Vantagens de usar o Npgsql

Desempenho: A velocidade e a eficiência do Npgsql são inerentes ao programa. Para garantir velocidade ideal ao trabalhar com bancos de dados PostgreSQL, utiliza recursos como processamento em lote de comandos, entrada/saída assíncrona e tipos de dados otimizados.

Suporte completo ao PostgreSQL: O objetivo do Npgsql é oferecer suporte completo a todas as funcionalidades do PostgreSQL, como arrays, JSONB, tipos de dados avançados e tipos definidos pelo usuário. Isso significa que os programadores podem aproveitar todo o potencial do PostgreSQL em seus aplicativos .NET .

1.2 Introdução ao Npgsql

using Npgsql;
using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // PostgreSQL connection string
        string connString = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase";

        // Create connection object
        using (var conn = new NpgsqlConnection(connString))
        {
            // Open the connection
            await conn.OpenAsync();

            // SQL query to execute
            string sql = "SELECT * FROM myTable";

            // Create NpgsqlCommand
            using (var cmd = new NpgsqlCommand(sql, conn))
            {
                // Execute the command and retrieve data
                using (var reader = await cmd.ExecuteReaderAsync())
                {
                    // Loop through the retrieved data
                    while (await reader.ReadAsync())
                    {
                        // Retrieve data from the data reader
                        string name = reader["Name"].ToString();
                        int age = Convert.ToInt32(reader["Age"]);
                        // Output retrieved data to console
                        Console.WriteLine($"Name: {name}, Age: {age}");
                    }
                }
            }
            // Connection will be automatically closed here due to the 'using' block
        }
    }
}

using Npgsql;
using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // PostgreSQL connection string
        string connString = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase";

        // Create connection object
        using (var conn = new NpgsqlConnection(connString))
        {
            // Open the connection
            await conn.OpenAsync();

            // SQL query to execute
            string sql = "SELECT * FROM myTable";

            // Create NpgsqlCommand
            using (var cmd = new NpgsqlCommand(sql, conn))
            {
                // Execute the command and retrieve data
                using (var reader = await cmd.ExecuteReaderAsync())
                {
                    // Loop through the retrieved data
                    while (await reader.ReadAsync())
                    {
                        // Retrieve data from the data reader
                        string name = reader["Name"].ToString();
                        int age = Convert.ToInt32(reader["Age"]);
                        // Output retrieved data to console
                        Console.WriteLine($"Name: {name}, Age: {age}");
                    }
                }
            }
            // Connection will be automatically closed here due to the 'using' block
        }
    }
}

Imports Npgsql
Imports System
Imports System.Threading.Tasks

Friend Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		' PostgreSQL connection string
		Dim connString As String = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase"

		' Create connection object
		Using conn = New NpgsqlConnection(connString)
			' Open the connection
			Await conn.OpenAsync()

			' SQL query to execute
			Dim sql As String = "SELECT * FROM myTable"

			' Create NpgsqlCommand
			Using cmd = New NpgsqlCommand(sql, conn)
				' Execute the command and retrieve data
				Using reader = Await cmd.ExecuteReaderAsync()
					' Loop through the retrieved data
					Do While Await reader.ReadAsync()
						' Retrieve data from the data reader
						Dim name As String = reader("Name").ToString()
						Dim age As Integer = Convert.ToInt32(reader("Age"))
						' Output retrieved data to console
						Console.WriteLine($"Name: {name}, Age: {age}")
					Loop
				End Using
			End Using
			' Connection will be automatically closed here due to the 'using' block
		End Using
	End Function
End Class

2.1 Consultas parametrizadas com PostgreSQL

Como as consultas parametrizadas permitem que o servidor de banco de dados armazene em cache os planos de consulta, elas melhoram o desempenho das consultas e ajudam a prevenir ataques de injeção de SQL. O Npgsql suporta consultas parametrizadas. Além disso, trabalhar com consultas SQL dinâmicas de forma segura e eficaz torna-se mais fácil com consultas parametrizadas.

2.2 Operações em lote com PostgreSQL

Ao trabalhar com conjuntos de dados enormes, as ações de inserção, atualização e exclusão em massa suportadas pelo Npgsql podem aumentar significativamente a velocidade. A sobrecarga de realizar viagens de ida e volta separadas ao servidor de banco de dados é reduzida quando várias linhas podem ser processadas em uma única transação de banco de dados graças às operações em lote.

Transações com PostgreSQL

As transações são suportadas pelo Npgsql, que permite o agrupamento de várias operações de banco de dados em uma única unidade atômica. As transações garantem a consistência e a integridade dos dados, seja confirmando todas as alterações no banco de dados ou revertendo toda a transação em caso de erro.

2.3 Otimização de desempenho com PostgreSQL

Ao trabalhar com bancos de dados PostgreSQL, o Npgsql oferece uma série de melhorias de desempenho, incluindo cache de planos de consulta, streaming de resultados e processamento em lote de comandos, para reduzir a latência e aumentar a taxa de transferência. A escalabilidade e a velocidade geral da aplicação são aprimoradas por essas melhorias.

2.4 Conexão com o banco de dados PostgreSQL

É possível conectar-se facilmente ao servidor de banco de dados PostgreSQL com a ajuda do Npgsql, utilizando algumas linhas de código, conforme mostrado abaixo.

NpgsqlConnection conn = new NpgsqlConnection(connString);

NpgsqlConnection conn = new NpgsqlConnection(connString);

Dim conn As New NpgsqlConnection(connString)

Este pequeno trecho de código nos ajuda a conectar com o servidor de banco de dados PostgreSQL.

3.1 Utilizando Npgsql e IronPDF em conjunto

Possibilidades empolgantes surgem quando Npgsql e IronPDF são usados ​​juntos em um projeto C#. Embora o Npgsql seja uma ótima ferramenta para trabalhar com PostgreSQL, o IronPDF é uma ferramenta excelente para converter esse conteúdo em PDFs. Graças a essa conectividade, os programadores podem criar aplicativos capazes de se comunicar com bancos de dados e transformar esse conteúdo em PDFs.

3.2 Obtendo dados do PostgreSQL com o IronPDF

Os usuários podem interagir com o banco de dados dentro do seu aplicativo criando um aplicativo de console do Windows que utiliza o Npgsql. Primeiro, adicione o acesso ao banco de dados ao seu aplicativo. Deve haver espaço suficiente no console para esse controle, deixando bastante espaço para as interações com o banco de dados. Inclui também o mapeamento de tipos de dados e operações em lote.

Instale o IronPDF

• Inicie o projeto no Visual Studio.

• Selecione "Ferramentas" > "Gerenciador de Pacotes NuGet " > "Console do Gerenciador de Pacotes".

  • Digite o seguinte comando no Console do Gerenciador de Pacotes e pressione Enter:

  Install-Package IronPdf

• Alternativamente, você também pode instalar o IronPDF usando o Gerenciador de Pacotes NuGet para Soluções.
  • Encontre o pacote IronPDF nos resultados da pesquisa, selecione-o e clique no botão "Instalar". O Visual Studio cuidará do download e da instalação automaticamente.

O pacote IronPDF será baixado e instalado pelo NuGet juntamente com todas as dependências necessárias para o seu projeto.

• Após a instalação, você poderá começar a utilizar o IronPDF em seu projeto.

Instale através do site do NuGet.

Para obter mais informações sobre o IronPDF, incluindo recursos, compatibilidade e outras opções de download, acesse o pacote IronPDF no site do NuGet .

Utilize DLL para instalar

Como alternativa, você pode usar o arquivo DLL do IronPDF para integrá-lo diretamente ao seu projeto. Utilize este link do pacote ZIP do IronPDF para baixar o arquivo ZIP contendo a DLL. Após descompactar o arquivo, adicione a DLL ao seu projeto.

Implementando a lógica

Ao iniciar a execução da aplicação, ela buscará os dados no banco de dados utilizando a biblioteca Npgsql .NET . Com a ajuda do IronPDF, conseguimos converter o conteúdo do banco de dados em um documento PDF.

1. Obtenção de dados: Obtenha o conteúdo mais recente do provedor Npgsql .NET quando o usuário iniciar a conversão.
2. Gerar PDF com IronPDF: Para converter os dados do banco de dados Npgsql em um PDF, use o IronPDF. A string HTML pode ser formatada em um documento PDF usando a classe HtmlToPdf.
3. Salvar PDF e notificar: Salve o PDF gerado em um local específico ou deixe uma mensagem visível no console. Notifique o usuário — possivelmente por meio de uma mensagem no terminal — de que a conversão foi bem-sucedida assim que o PDF for salvo.

using Npgsql;
using IronPdf;
using System;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // StringBuilder for HTML content
        StringBuilder sb = new StringBuilder();
        var Renderer = new ChromePdfRenderer(); // Instantiates Chrome Renderer

        sb.Append("<h1>Dynamic PDF Generated from PostgreSQL Data</h1>");

        // PostgreSQL connection setup
        string connString = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase";

        using (var conn = new NpgsqlConnection(connString))
        {
            await conn.OpenAsync();

            string sql = "SELECT * FROM myTable";
            using (var cmd = new NpgsqlCommand(sql, conn))
            {
                using (var reader = await cmd.ExecuteReaderAsync())
                {
                    while (await reader.ReadAsync())
                    {
                        // Retrieve data from the data reader
                        string name = reader["Name"].ToString();
                        int age = Convert.ToInt32(reader["Age"]);

                        // Add data to the PDF
                        sb.Append($"<p>Name: {name}, Age: {age}</p>");
                    }
                }
            }

            // Generate and save the PDF document
            var pdf = Renderer.RenderHtmlAsPdf(sb.ToString());
            pdf.SaveAs("output.pdf");

            // Connection will be automatically closed here
        }

        Console.WriteLine("PDF generation completed. See output.pdf for results.");
    }
}

using Npgsql;
using IronPdf;
using System;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // StringBuilder for HTML content
        StringBuilder sb = new StringBuilder();
        var Renderer = new ChromePdfRenderer(); // Instantiates Chrome Renderer

        sb.Append("<h1>Dynamic PDF Generated from PostgreSQL Data</h1>");

        // PostgreSQL connection setup
        string connString = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase";

        using (var conn = new NpgsqlConnection(connString))
        {
            await conn.OpenAsync();

            string sql = "SELECT * FROM myTable";
            using (var cmd = new NpgsqlCommand(sql, conn))
            {
                using (var reader = await cmd.ExecuteReaderAsync())
                {
                    while (await reader.ReadAsync())
                    {
                        // Retrieve data from the data reader
                        string name = reader["Name"].ToString();
                        int age = Convert.ToInt32(reader["Age"]);

                        // Add data to the PDF
                        sb.Append($"<p>Name: {name}, Age: {age}</p>");
                    }
                }
            }

            // Generate and save the PDF document
            var pdf = Renderer.RenderHtmlAsPdf(sb.ToString());
            pdf.SaveAs("output.pdf");

            // Connection will be automatically closed here
        }

        Console.WriteLine("PDF generation completed. See output.pdf for results.");
    }
}

Imports Npgsql
Imports IronPdf
Imports System
Imports System.Text
Imports System.Threading.Tasks

Friend Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		' StringBuilder for HTML content
		Dim sb As New StringBuilder()
		Dim Renderer = New ChromePdfRenderer() ' Instantiates Chrome Renderer

		sb.Append("<h1>Dynamic PDF Generated from PostgreSQL Data</h1>")

		' PostgreSQL connection setup
		Dim connString As String = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase"

		Using conn = New NpgsqlConnection(connString)
			Await conn.OpenAsync()

			Dim sql As String = "SELECT * FROM myTable"
			Using cmd = New NpgsqlCommand(sql, conn)
				Using reader = Await cmd.ExecuteReaderAsync()
					Do While Await reader.ReadAsync()
						' Retrieve data from the data reader
						Dim name As String = reader("Name").ToString()
						Dim age As Integer = Convert.ToInt32(reader("Age"))

						' Add data to the PDF
						sb.Append($"<p>Name: {name}, Age: {age}</p>")
					Loop
				End Using
			End Using

			' Generate and save the PDF document
			Dim pdf = Renderer.RenderHtmlAsPdf(sb.ToString())
			pdf.SaveAs("output.pdf")

			' Connection will be automatically closed here
		End Using

		Console.WriteLine("PDF generation completed. See output.pdf for results.")
	End Function
End Class

Abaixo está o resultado gerado pelo código acima. Para saber mais sobre a documentação do IronPDF , consulte o guia.