C#PostgreSQL教程展示了如何在C#中对PostgreSQL进行编程。它涵盖了使用C#进行PostgreSQL编程的基础知识。
PostgreSQL
PostgreSQL是一个功能强大的开源对象关系数据库系统。它是一个多用户数据库管理系统。它运行在多个平台上，包括Linux、FreeBSD、Solaris、MicrosoftWindows和MacOSX。PostgreSQL由PostgreSQL全球开发组开发。
PostgreSQL具有复杂的功能，例如多版本并发控制(MVCC)、时间点恢复、表空间、异步复制、嵌套事务（保存点）、在线/热备份、复杂的查询计划器/优化器和故障预写日志宽容。它支持国际字符集、多字节字符编码、Unicode，并且在排序、区分大小写和格式化方面具有区域设置意识。
ADO.NET
ADO.NET是.NET的重要组成部分。它是统一访问关系数据库、XML文件和其他应用程序数据的规范。Npgsql是PostgreSQL数据库的ADO.NET规范的实现。它是一个用C#语言编写的驱动程序，适用于所有.NET语言。
$ dotnet add package Npgsql
我们将包包含到我们的.NETCore项目中。
NpgsqlConnection、NpgsqlCommand、NpgsqlDataReader、DataSet和NpgsqlDataProvider是.NET数据提供者模型的核心元素。NpgsqlConnection创建到特定数据源的连接。NpgsqlCommand对象针对数据源执行SQL语句。NpgsqlDataReader从数据源读取数据流。
DataSet对象用于离线处理大量数据。它是一种断开连接的数据表示，可以保存来自各种不同来源的数据。NpgsqlDataReader和DataSet都用于处理数据；它们在不同的情况下使用。如果我们只需要读取查询结果，NpgsqlDataReader是更好的选择。如果我们需要更广泛的数据处理，或者我们想将Winforms控件绑定到数据库表，则首选DataSet。
C#PostgreSQL版本
如果下面的程序我们检查PostgreSQL服务器的版本。
using Npgsql;
var cs = "Host=localhost;Username=postgres;Password=s$cret;Database=testdb";
using var con = new NpgsqlConnection(cs);
con.Open();
var sql = "SELECT version()";
using var cmd = new NpgsqlCommand(sql, con);
var version = cmd.ExecuteScalar().ToString();
Console.WriteLine($"PostgreSQL version: {version}");
我们连接到数据库并获取有关PostgreSQL服务器的一些信息。
using Npgsql;
我们导入PostgreSQL数据提供程序的元素。
var cs = "Host=localhost;Username=postgres;Password=s$cret;Database=testdb";
这是连接字符串。数据提供者使用它来建立与数据库的连接。我们指定主机名、用户名、密码和数据库名。
using var con = new NpgsqlConnection(cs);
NpgsqlConnection对象被创建。该对象用于打开与数据库的连接。using语句在变量超出范围时释放数据库连接资源。
con.Open();
这一行打开数据库连接。
var sql = "SELECT version()";
这是SQLSELECT语句。它返回数据库的版本。version是内置的PostgreSQL函数。
using var cmd = new NpgsqlCommand(sql, con);
NpgsqlCommand是一个用于对数据库执行查询的对象。参数是SQL语句和连接对象。
var version = cmd.ExecuteScalar().ToString();
有些查询只返回一个标量值。在我们的例子中，我们需要一个简单的字符串来指定数据库的版本。在这种情况下使用ExecuteScalar。
Console.WriteLine($"PostgreSQL version: {version}");
我们将PostgreSQL的版本打印到控制台。
$ dotnet run PostgreSQL version: PostgreSQL 11.1, compiled by Visual C++ build 1914, 64-bit
C#PostgreSQL创建表
在下面的例子中，我们创建了一个数据库表并用数据填充它。
using Npgsql;
var cs = "Host=localhost;Username=postgres;Password=s$cret;Database=testdb";
using var con = new NpgsqlConnection(cs);
con.Open();
using var cmd = new NpgsqlCommand();
cmd.Connection = con;
cmd.CommandText = "DROP TABLE IF EXISTS cars";
cmd.ExecuteNonQuery();
cmd.CommandText = @"CREATE TABLE cars(id SERIAL PRIMARY KEY,
name VARCHAR(255), price INT)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Audi',52642)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Mercedes',57127)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Skoda',9000)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Volvo',29000)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Bentley',350000)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Citroen',21000)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Hummer',41400)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Volkswagen',21600)";
cmd.ExecuteNonQuery();
Console.WriteLine("Table cars created");
在示例中，我们创建了一个包含八行的cars表。
cmd.CommandText = "DROP TABLE IF EXISTS cars"; cmd.ExecuteNonQuery();
如果表已经存在，我们首先删除它。如果我们不想要结果集，例如DROP、INSERT或DELETE，我们可以使用ExecuteNonQuery方法声明。
cmd.CommandText = @"CREATE TABLE cars(id SERIAL PRIMARY KEY,
name VARCHAR(255), price INT)";
cmd.ExecuteNonQuery();
cars表已创建。SERIAL关键字使该列在PostgreSQL中自动递增。
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Audi',52642)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Mercedes',57127)";
cmd.ExecuteNonQuery();
...
这里我们向表中插入两行。
$ dotnet run Table cars created
我们运行程序。
$ psql -U postgres testdb psql (11.1) Type "help" for help.
我们使用psql工具连接到PostgreSQL服务器。
testdb=# SELECT * FROM cars; id | name | price ----+------------+-------- 1 | Audi | 52642 2 | Mercedes | 57127 3 | Skoda | 9000 4 | Volvo | 29000 5 | Bentley | 350000 6 | Citroen | 21000 7 | Hummer | 41400 8 | Volkswagen | 21600 (10 rows)
我们验证数据。cars表已成功创建。
C#PostgreSQL预处理语句
准备好的语句提高了安全性和性能。当我们编写准备好的语句时，我们使用占位符而不是直接将值写入语句。
using Npgsql;
var cs = "Host=localhost;Username=postgres;Password=s$cret;Database=testdb";
using var con = new NpgsqlConnection(cs);
con.Open();
var sql = "INSERT INTO cars(name, price) VALUES(@name, @price)";
using var cmd = new NpgsqlCommand(sql, con);
cmd.Parameters.AddWithValue("name", "BMW");
cmd.Parameters.AddWithValue("price", 36600);
cmd.Prepare();
cmd.ExecuteNonQuery();
Console.WriteLine("row inserted");
我们在cars表中添加了一辆新车。我们使用参数化命令。
var sql = "INSERT INTO cars(name, price) VALUES(@name, @price)"; using var cmd = new NpgsqlCommand(sql, con);
当我们编写准备好的语句时，我们使用占位符而不是直接将值写入语句。准备好的语句速度更快，可以防止SQL注入攻击。@name和@price是占位符，稍后会被填充。
cmd.Parameters.AddWithValue("name", "BMW");
cmd.Parameters.AddWithValue("price", 36600);
cmd.Prepare();
使用AddWithValue方法将值绑定到占位符。
cmd.ExecuteNonQuery();
准备好的语句被执行。当我们不希望返回任何数据时，我们使用NpgsqlCommand对象的ExecuteNonQuery方法。
C#NpgsqlDataReader
NpgsqlDataReader是一个用于从数据库中检索数据的对象。它提供对查询结果的快速、只进、只读访问。这是从表中检索数据的最有效方法。
using Npgsql;
var cs = "Host=localhost;Username=postgres;Password=s$cret;Database=testdb";
using var con = new NpgsqlConnection(cs);
con.Open();
string sql = "SELECT * FROM cars";
using var cmd = new NpgsqlCommand(sql, con);
using NpgsqlDataReader rdr = cmd.ExecuteReader();
while (rdr.Read())
{
Console.WriteLine("{0} {1} {2}", rdr.GetInt32(0), rdr.GetString(1),
rdr.GetInt32(2));
}
我们从cars表中获取所有行并将它们打印到控制台。
using NpgsqlDataReader rdr = cmd.ExecuteReader();
要创建一个NpgsqlDataReader，我们调用NpgsqlCommand对象的ExecuteReader方法。
while (rdr.Read())
{
Console.WriteLine("{0} {1} {2}", rdr.GetInt32(0), rdr.GetString(1),
rdr.GetInt32(2));
}
Read方法将数据读取器推进到下一条记录。如果有更多行，它返回true；否则为false。我们可以使用数组索引符号检索值，或使用特定方法访问其本机数据类型中的列值。后者效率更高。
$ dotnet run 1 Audi 52642 2 Mercedes 57127 3 Skoda 9000 4 Volvo 29000 5 Bentley 350000 6 Citroen 21000 7 Hummer 41400 8 Volkswagen 21600 9 BMW 36600
C#PostgreSQL列标题
在下面的示例中，我们使用数据库表中的数据打印列标题。
using Npgsql;
var cs = "Host=localhost;Username=postgres;Password=s$cret;Database=testdb";
using var con = new NpgsqlConnection(cs);
con.Open();
var sql = "SELECT * FROM cars";
using var cmd = new NpgsqlCommand(sql, con);
using NpgsqlDataReader rdr = cmd.ExecuteReader();
Console.WriteLine($"{rdr.GetName(0),-4} {rdr.GetName(1),-10} {rdr.GetName(2),10}");
while (rdr.Read())
{
Console.WriteLine($"{rdr.GetInt32(0),-4} {rdr.GetString(1),-10} {rdr.GetInt32(2),10}");
}
在示例中，我们从cars表中选择所有行及其列名。
Console.WriteLine($"{rdr.GetName(0),-4} {rdr.GetName(1),-10} {rdr.GetName(2),10}");
我们使用thereader的GetName方法获取列的名称。
while (rdr.Read())
{
Console.WriteLine($"{rdr.GetInt32(0),-4} {rdr.GetString(1),-10} {rdr.GetInt32(2),10}");
}
我们将SQL语句返回的数据打印到终端。
$ dotnet run id name price 1 Audi 52642 2 Mercedes 57127 3 Skoda 9000 4 Volvo 29000 5 Bentley 350000 6 Citroen 21000 7 Hummer 41400 8 Volkswagen 21600 9 BMW 36600
在本文中，我们展示了如何使用C#编写PostgreSQL数据库。
列出所有C#教程。
