C#怎么操作PostgreSQL数据库 C#如何用Npgsql连接和操作PostgreSQL进行数据读写【数据库】

尼克

尼克

2026-03-30

582人浏览

原创

安装npgsql包需区分用途:纯ado.net用npgsql,ef core用npgsql.entityframeworkcore.postgresql;连接字符串须含password和timeout;参数用:name非@name;异步操作必须await;连接池需合理配置。

c#怎么操作postgresql数据库 c#如何用npgsql连接和操作postgresql进行数据读写【数据库】

安装 Npgsql 包时别漏掉 NpgsqlNpgsql.EntityFrameworkCore.PostgreSQL 的区别

直接用 Npgsql 做 ADO.NET 操作,和用 EF Core 是两套路径。新手常在 NuGet 里搜 “postgres” 顺手装了 Npgsql.EntityFrameworkCore.PostgreSQL,结果写 NpgsqlConnection 时发现类型找不到——因为那个包只提供 EF Core 的扩展,不带基础驱动。

  • 纯 SQL 执行、手动控制连接/事务:只装 Npgsql
  • 要用 DbContext + LINQ 查询:装 Npgsql.EntityFrameworkCore.PostgreSQL(它会自动拉取 Npgsql 作为依赖)
  • EF Core 7+ 连 PostgreSQL 时,连接字符串里必须加 Server Compatibility Mode=Redshift 吗?不用,那是给 Redshift 兼容用的,PostgreSQL 默认不启用

NpgsqlConnection 连接字符串写错会导致 Invalid operation: connection is closed

不是连接没开,是连接根本没成功,但代码里没检查就直接 Open()ExecuteReader(),结果抛出这个看似“已关闭”的误导性错误。

C函数速查手册(CHM版)
C函数速查手册(CHM版)

C函数速查手册(CHM版)

下载
  • 典型错误写法:"Host=localhost;Port=5432;Database=mydb;Username=postgres" —— 少了 Password,且没设 Timeout,连接卡住几秒后直接超时失败
  • 正确写法示例:"Host=localhost;Port=5432;Database=mydb;Username=postgres;Password=123;Timeout=30"
  • 连接前务必加 try/catch 捕获 NpgsqlException,它的 SqlState 字段能告诉你真实原因(比如 28000 是认证失败,3D000 是数据库不存在)

NpgsqlCommand 执行 INSERT 时参数名大小写敏感,且不能用 @ 前缀

PostgreSQL 原生用 $1, $2 占位符,Npgsql 支持命名参数但语法是 :name,不是 SQL Server 风格的 @name。写成 @id 不报错,但参数根本不会绑定,值全为 NULL。

using var cmd = new NpgsqlCommand("INSERT INTO users (name, age) VALUES (:name, :age)", conn);
cmd.Parameters.AddWithValue(":name", "Alice"); // 注意冒号,不是 @
cmd.Parameters.AddWithValue(":age", 25);
  • 参数名必须和 SQL 中的 :xxx 完全一致(包括大小写),:Name:name
  • AddWithValue 要小心类型推断错误,比如传 null 可能被当成 int 导致类型不匹配;明确类型推荐用 Addcmd.Parameters.Add(":age", NpgsqlDbType.Integer).Value = 25;
  • 批量插入别拼 SQL 字符串,用 UNNESTVALUES 多行,Npgsql 支持一次传多个 :param 数组

异步方法如 ExecuteReaderAsync 必须配合 await,否则线程卡死或连接泄漏

写了 async 方法却忘了 await,或者用 .Result 强制同步等待,在 ASP.NET Core 里极易引发线程池饥饿,表现就是请求变慢、连接堆积、后续请求超时。

  • 错误示范:var reader = cmd.ExecuteReaderAsync().Result; —— 阻塞线程,还可能死锁
  • 正确写法:整个调用链保持 async/await,从 Controller Action 到 DAL 层都用 async Task<t></t>
  • 注意 NpgsqlConnection.OpenAsync() 也得 await,不是只有查询才需要
  • 如果真要同步(比如老项目无法改 async),至少用 Open() + ExecuteReader(),别混用同步/异步 API
连接字符串里的 Pooling 默认是 true,本地开发时容易忽略连接未释放导致“too many clients”错误;实际部署还要看 Max Pool Size 和数据库的 max_connections 是否匹配——这点不调参,压测时第一个崩的往往就是连接池。

相关专题

更多
c#是什么意思
c#是什么意思

C#是一种通用的面向对象编程语言,它在.NET框架上运行,可用于开发各种类型的应用程序。本专题为大家提供c#相关的各种文章、以及下载和课程。

2023.08.08

529

5

什么是c#
什么是c#

C#(读作C Sharp)是一种现代的、通用的、面向对象的编程语言。它由微软公司开发,于2000年首次发布,主要用于开发Windows桌面应用程序、Web应用程序、移动应用程序以及游戏开发等领域。C#是一种类型安全和托管的编程语言,它结合了C++的强大性能和C语言的简单易学特点,并引入了许多新的特性和概念,如委托、属性、泛型和异步编程等,以提高开发效率和代码可维护性。

2023.08.31

1182

3

C#中base关键字的用法
C#中base关键字的用法

在C#中,base关键字用于访问当前类的基类成员,这包括基类的字段、属性、方法、构造函数、索引器以及事件。想了解更多C#的相关内容,可以阅读本专题下面的文章。

2024.03.13

557

8

C#Task用法
C#Task用法

Task在C#中是用于表示异步操作的对象,它位于System.Threading.Tasks命名空间中。想了解更多C#中各种用法的相关内容,可以阅读本专题下面的文章。

2024.03.14

1053

11

C# 并发与异步编程
C# 并发与异步编程

本专题系统讲解 C# 异步编程与并发控制,重点介绍 async 和 await 关键字、Task 类、线程池管理、并发数据结构、死锁与线程安全问题。通过多个实战项目,帮助学习者掌握 如何在 C# 中编写高效的异步代码,提升应用的并发性能与响应速度。

2026.02.03

169

18

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

2026.02.06

203

20

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

2026.03.11

526

24

C# Unity游戏开发与ECS架构实践
C# Unity游戏开发与ECS架构实践

本专题聚焦 C# 在 Unity 游戏开发中的应用,系统讲解 ECS(Entity-Component-System)架构设计、游戏对象管理、性能优化与内存控制策略。通过实际游戏案例,帮助开发者构建高性能、结构清晰的游戏系统,提高游戏开发效率与运行性能。

2026.04.13

139

20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
RabbitMQ 教程手册
RabbitMQ 教程手册

共0课时 | 0人学习

Linux man-pages 项目
Linux man-pages 项目

共0课时 | 0人学习

C# 教程
C# 教程

共94课时 | 20.2万人学习