C# PostgreSQL (Como funciona para desenvolvedores)

Instalando o Npgsql

Abra o projeto recém-criado no Visual Studio. No Explorador de Soluções, clique com o botão direito do mouse no seu projeto, selecione "Gerenciar Pacotes NuGet " e procure pelo pacote Npgsql. Instale-o clicando no botão "Instalar" ao lado do nome do pacote. Esta ação adiciona o provedor de dados Npgsql ao seu projeto, permitindo que seu aplicativo se comunique com o PostgreSQL. Você também pode instalá-lo usando o console do gerenciador de pacotes.

Configurando a conexão com o banco de dados

O primeiro passo para interagir com um banco de dados PostgreSQL a partir do C# é estabelecer uma conexão. Isso requer uma string de conexão, que inclui detalhes como o nome do servidor, a porta, o nome de usuário e a senha. Aqui está um modelo básico para uma string de conexão PostgreSQL:

string connectionString = "Host=localhost; Port=5432; Username=postgres; Password=yourpassword; Database=mydatabase";

string connectionString = "Host=localhost; Port=5432; Username=postgres; Password=yourpassword; Database=mydatabase";

Dim connectionString As String = "Host=localhost; Port=5432; Username=postgres; Password=yourpassword; Database=mydatabase"

Substitua localhost , suasenha e meubanco de dados pelos detalhes do seu servidor PostgreSQL.

Definindo o Modelo de Empregado

Definimos um modelo de entidade "Funcionário" que representará nossos dados no banco de dados PostgreSQL. Este modelo inclui propriedades que correspondem às colunas da tabela do banco de dados.

public class Employee
{
    public int Id { get; set; } // Automatically becomes the primary key
    public string LastName { get; set; }
}

public class Employee
{
    public int Id { get; set; } // Automatically becomes the primary key
    public string LastName { get; set; }
}

Public Class Employee
	Public Property Id() As Integer ' -  Automatically becomes the primary key
	Public Property LastName() As String
End Class

Este trecho de código define uma classe Employee simples com duas propriedades: Id e LastName . O Entity Framework Core usa convenções para inferir que a propriedade de chave primária serial Id deve ser tratada como a chave primária.

Configurando o DbContext do aplicativo

A classe AppDbContext estende a classe DbContext do Entity Framework Core, atuando como uma ponte entre sua aplicação C# e o banco de dados PostgreSQL. Inclui detalhes de configuração, como a string de conexão e as propriedades DbSet que representam as tabelas no banco de dados.

public class AppDbContext : DbContext
{
    public DbSet<Employee> Employees { get; set; } // Represents the Employees table

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        string connectionString = "Host=localhost; Port=5432; Username=postgres; Password=your_password; Database=your_database";
        optionsBuilder.UseNpgsql(connectionString);
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Employee>().ToTable("Employees");
    }
}

public class AppDbContext : DbContext
{
    public DbSet<Employee> Employees { get; set; } // Represents the Employees table

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        string connectionString = "Host=localhost; Port=5432; Username=postgres; Password=your_password; Database=your_database";
        optionsBuilder.UseNpgsql(connectionString);
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Employee>().ToTable("Employees");
    }
}

Public Class AppDbContext
	Inherits DbContext

	Public Property Employees() As DbSet(Of Employee) ' -  Represents the Employees table

	Protected Overrides Sub OnConfiguring(ByVal optionsBuilder As DbContextOptionsBuilder)
		Dim connectionString As String = "Host=localhost; Port=5432; Username=postgres; Password=your_password; Database=your_database"
		optionsBuilder.UseNpgsql(connectionString)
	End Sub

	Protected Overrides Sub OnModelCreating(ByVal modelBuilder As ModelBuilder)
		modelBuilder.Entity(Of Employee)().ToTable("Employees")
	End Sub
End Class

• Propriedade DbSet:** public DbSet Employees { get; set; } declara um conjunto de entidades Employees** que são mapeadas para a tabela de funcionários no banco de dados PostgreSQL.

• Método OnConfiguring: Este método configura o DbContext com a string de conexão de banco de dados necessária. Substitua your_password e your_database pelos dados reais do seu servidor PostgreSQL.

• Método OnModelCreating: Aqui, você pode usar a API Fluent para configurar ainda mais os comportamentos da entidade. Neste exemplo, especificamos o nome da tabela explicitamente, embora seja opcional se o nome da tabela corresponder ao nome da propriedade DbSet .

Lógica principal do programa

No método Main da classe Program , garantimos que o banco de dados seja criado, o preenchemos com dados iniciais, caso esteja vazio, e então executamos uma consulta para recuperar e exibir os dados dos funcionários.

class Program
{
    static void Main(string[] args)
    {
        using (var context = new AppDbContext())
        {
            context.Database.EnsureCreated();  // Ensure the database and schema are created
            if (!context.Employees.Any())  // Check if the Employees table is empty
            {
                context.Employees.Add(new Employee { LastName = "Software" });
                context.SaveChanges();  // Save changes to the database
            }
            var employees = context.Employees.Where(e => e.LastName == "Software").ToList();
            foreach (var employee in employees)
            {
                Console.WriteLine($"Employee ID: {employee.Id}, Last Name: {employee.LastName}");
            }
        }
    }
}

class Program
{
    static void Main(string[] args)
    {
        using (var context = new AppDbContext())
        {
            context.Database.EnsureCreated();  // Ensure the database and schema are created
            if (!context.Employees.Any())  // Check if the Employees table is empty
            {
                context.Employees.Add(new Employee { LastName = "Software" });
                context.SaveChanges();  // Save changes to the database
            }
            var employees = context.Employees.Where(e => e.LastName == "Software").ToList();
            foreach (var employee in employees)
            {
                Console.WriteLine($"Employee ID: {employee.Id}, Last Name: {employee.LastName}");
            }
        }
    }
}

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Using context = New AppDbContext()
			context.Database.EnsureCreated() ' Ensure the database and schema are created
			If Not context.Employees.Any() Then ' Check if the Employees table is empty
				context.Employees.Add(New Employee With {.LastName = "Software"})
				context.SaveChanges() ' Save changes to the database
			End If
			Dim employees = context.Employees.Where(Function(e) e.LastName = "Software").ToList()
			For Each employee In employees
				Console.WriteLine($"Employee ID: {employee.Id}, Last Name: {employee.LastName}")
			Next employee
		End Using
	End Sub
End Class

O código acima verifica se o banco de dados existe e o cria juntamente com o esquema, caso não exista. É uma maneira simples de inicializar um novo banco de dados durante o desenvolvimento. Esta instrução SQL verifica se a tabela Funcionários está vazia; caso contrário, o programa adiciona um novo funcionário com o sobrenome "Software" e salva as alterações no banco de dados. O programa consulta a tabela de Funcionários em busca de entradas com o sobrenome "Software" e imprime seus detalhes no console.

Saída

Aqui está a saída do console ao executar o programa:

E são os dados da tabela no PgAdmin:

Instalando o IronPDF

Antes de poder usar o IronPDF, você precisa adicioná-lo ao seu projeto. Isso pode ser feito facilmente através do Gerenciador de Pacotes NuGet :

Install-Package IronPdf

Gerando um PDF a partir de dados do PostgreSQL

Neste exemplo, vamos gerar um relatório PDF simples que lista os funcionários do nosso banco de dados PostgreSQL. Vamos assumir que você configurou o AppDbContext e o modelo Employee conforme descrito nas seções anteriores.

Primeiro, certifique-se de que a biblioteca IronPDF esteja instalada em seu projeto. Em seguida, você pode usar o seguinte código para buscar dados do banco de dados PostgreSQL e gerar um relatório em PDF:

class Program
{
    static void Main(string[] args)
    {
        IronPdf.License.LicenseKey = "Key";
        // Initialize the database context
        using (var context = new AppDbContext())
        {
            // Fetch employees from the database
            var employees = context.Employees.ToList();
            // Generate HTML content for the PDF
            var htmlContent = "<h1>Employee Report</h1>";
            htmlContent += "<table><tr><th>ID</th><th>Last Name</th></tr>";
            foreach (var employee in employees)
            {
                htmlContent += $"<tr><td>{employee.Id}</td><td>{employee.LastName}</td></tr>";
            }
            htmlContent += "</table>";
            // Instantiate the IronPDF HtmlToPdf converter
            var renderer = new ChromePdfRenderer();
            // Generate the PDF document from the HTML content
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);
            // Save the generated PDF to a file
            var outputPath = "f:\\EmployeeReport.pdf";
            pdf.SaveAs(outputPath);
            Console.WriteLine($"PDF report generated: {outputPath}");
        }
    }
}

class Program
{
    static void Main(string[] args)
    {
        IronPdf.License.LicenseKey = "Key";
        // Initialize the database context
        using (var context = new AppDbContext())
        {
            // Fetch employees from the database
            var employees = context.Employees.ToList();
            // Generate HTML content for the PDF
            var htmlContent = "<h1>Employee Report</h1>";
            htmlContent += "<table><tr><th>ID</th><th>Last Name</th></tr>";
            foreach (var employee in employees)
            {
                htmlContent += $"<tr><td>{employee.Id}</td><td>{employee.LastName}</td></tr>";
            }
            htmlContent += "</table>";
            // Instantiate the IronPDF HtmlToPdf converter
            var renderer = new ChromePdfRenderer();
            // Generate the PDF document from the HTML content
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);
            // Save the generated PDF to a file
            var outputPath = "f:\\EmployeeReport.pdf";
            pdf.SaveAs(outputPath);
            Console.WriteLine($"PDF report generated: {outputPath}");
        }
    }
}

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		IronPdf.License.LicenseKey = "Key"
		' Initialize the database context
		Using context = New AppDbContext()
			' Fetch employees from the database
			Dim employees = context.Employees.ToList()
			' Generate HTML content for the PDF
			Dim htmlContent = "<h1>Employee Report</h1>"
			htmlContent &= "<table><tr><th>ID</th><th>Last Name</th></tr>"
			For Each employee In employees
				htmlContent &= $"<tr><td>{employee.Id}</td><td>{employee.LastName}</td></tr>"
			Next employee
			htmlContent &= "</table>"
			' Instantiate the IronPDF HtmlToPdf converter
			Dim renderer = New ChromePdfRenderer()
			' Generate the PDF document from the HTML content
			Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
			' Save the generated PDF to a file
			Dim outputPath = "f:\EmployeeReport.pdf"
			pdf.SaveAs(outputPath)
			Console.WriteLine($"PDF report generated: {outputPath}")
		End Using
	End Sub
End Class

Saída

Ao executar o código, a seguinte saída será exibida no console:

Este PDF foi gerado: