C# PostgreSQL（開発者向けの動作方法）

Npgsqlのインストール

新しく作成したプロジェクトをVisual Studioで開きます。 ソリューションエクスプローラーでプロジェクトを右クリックして"NuGetパッケージの管理"を選び、Npgsqlパッケージを検索します。 パッケージ名の隣にあるインストールボタンをクリックしてインストールします。 このアクションにより、Npgsqlデータプロバイダーがプロジェクトに追加され、アプリケーションがPostgreSQLと通信できるようになります。 パッケージマネージャーコンソールを使用してインストールすることもできます。

データベース接続の構成

C#からPostgreSQLデータベースと対話する最初のステップは接続を確立することです。 これには、サーバー名、ポート、ユーザー名、パスワードなどの詳細を含む接続文字列が必要です。 ここに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";

localhost、yourpassword、mydatabaseをあなたのPostgreSQLサーバーの詳細で置き換えてください。

従業員モデルの定義

私たちは、PostgreSQLデータベースでデータを表すEmployeeエンティティモデルを定義します。 このモデルには、データベーステーブルの列に対応するプロパティが含まれています。

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; }
}

このコードスニペットは、IdとLastNameの2つのプロパティを持つシンプルなEmployeeクラスを定義しています。 Entity Framework Coreは、Idシリアル主キーをプライマリキーとして扱うべきことを推測するために慣習を使用します。

アプリケーションのDbContextの構成

AppDbContextクラスは、Entity Framework CoreのDbContextを拡張し、C#アプリケーションとPostgreSQLデータベースの間の橋渡しの役割を果たします。 それには接続文字列やデータベース内のテーブルを表すDbSetプロパティなどの設定詳細が含まれています。

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");
    }
}

• DbSet プロパティ:**パブリック DbSet従業員 { 取得; set; } は、Employee**エンティティのセットを宣言し、PostgreSQLデータベース内の従業員テーブルにマッピングされます。

• OnConfiguring メソッド:このメソッドは、必要なデータベース接続文字列を使用してDbContextを構成します。 your_passwordとyour_databaseをあなたの実際のPostgreSQLサーバーの詳細で置き換えてください。

• OnModelCreating メソッド:ここでは、Fluent API を使用してエンティティの動作をさらに構成できます。 この例では、テーブル名を明示的に指定していますが、DbSetプロパティ名とテーブル名が一致する場合は省略可能です。

メインプログラムのロジック

ProgramクラスのMainメソッドでは、データベースが作成され、空の場合は初期データでシードされ、その後、クエリを実行して従業員データを取得して表示します。

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}");
            }
        }
    }
}

上記のコードは、データベースが存在するかどうかを確認し、スキーマと共に作成されていない場合は作成します。 これは、開発中に新しいデータベースをブートストラップするための簡単な方法です。 このSQL文は、Employeesテーブルが空の場合に、プログラムが"Software"という姓の新しいEmployeeを追加し、変更をデータベースに保存するかどうかを確認します。 プログラムは、Employeesテーブルの"Software"という姓のエントリをクエリし、その詳細をコンソールに表示します。

出力

プログラムを実行するときのコンソール出力はこちらです。

そして、それがPgAdminのテーブルデータです:

IronPDFのインストール

IronPDFを使用する前に、プロジェクトに追加する必要があります。 これはNuGetパッケージマネージャーを介して簡単に行うことができます。

Install-Package IronPdf

PostgreSQLデータからPDFを生成する

この例では、PostgreSQLデータベースから従業員のリストを表示する簡単なPDFレポートを生成しましょう。 以前のセクションで説明したように、AppDbContextとEmployeeモデルが設定されていることを前提とします。

最初に、プロジェクトにIronPDFライブラリがインストールされていることを確認してください。 その後、以下のコードを使用してPostgreSQLデータベースからデータを取得し、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}");
        }
    }
}

出力

コードを実行すると、このコンソール出力が表示されます:

このPDFが生成されました: