0

0

c# 如何连接 oracle 数据库

煙雲

煙雲

发布时间:2025-12-30 12:30:09

|

978人浏览过

|

来源于php中文网

原创

推荐使用 Oracle.ManagedDataAccess(非.Core版)连接Oracle数据库,它纯.NET实现、免客户端安装;注意区分.NET Framework与.NET Core/5+的包版本,连接字符串需正确配置,优先用using确保资源释放。

c# 如何连接 oracle 数据库

用 Oracle.ManagedDataAccess 连接 Oracle 数据库

推荐直接使用 Oracle.ManagedDataAccess(ODP.NET Managed Driver),它不依赖 Oracle 客户端安装,纯 .NET 实现,部署简单。NuGet 包名就是 Oracle.ManagedDataAccess,不是旧版的 System.Data.OracleClient(已弃用)或需要本地 Oracle Client 的 Oracle.DataAccess

常见错误:项目里装了 Oracle.ManagedDataAccess.Core 却在 .NET Framework 项目中引用 —— 这会导致运行时报 Could not load file or assembly 'Oracle.ManagedDataAccess' 。注意区分:.Core 仅用于 .NET Core / .NET 5+;传统 .NET Framework 项目必须用非 .Core 版本。

  • 在 Visual Studio 中右键项目 → “管理 NuGet 包” → 搜索并安装 Oracle.ManagedDataAccess(无 .Core 后缀)
  • 连接字符串格式示例:"User Id=myuser;Password=mypass;Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=myhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=orcl)))"
  • 若使用 TNS 别名(如 ORCL),确保 tnsnames.ora 在应用可访问路径下,或改用 EZConnect 格式:"User Id=myuser;Password=mypass;Data Source=myhost:1521/orcl"

写一个最小可用的 OracleConnection 打开测试

别一上来就写 ORM 或封装类,先验证驱动和连接是否通。重点看 Open() 是否抛异常,以及异常类型 —— 大部分连不上都是连接字符串或网络问题,不是代码逻辑问题。

using Oracle.ManagedDataAccess.Client;

string connStr = "User Id=scott;Password=tiger;Data Source=localhost:1521/orcl"; using (var conn = new OracleConnection(connStr)) { try { conn.Open(); Console.WriteLine("✅ 连接成功,版本:" + conn.ServerVersion); } catch (OracleException ex) { Console.WriteLine("❌ Oracle 错误:" + ex.Number + " - " + ex.Message); } catch (Exception ex) { Console.WriteLine("❌ 其他异常:" + ex.Message); } }

注意:OracleExceptionNumber 字段很关键,比如 ORA-12154 是解析不到服务名,ORA-12541 是监听器没响应,ORA-01017 是用户名密码错 —— 这些数字比错误消息更可靠,适合日志分类。

执行查询时要注意参数命名和数据类型

Oracle 的参数前缀是冒号 :,不是 @ 或 ?,且**大小写敏感**。同时,OracleParameterOracleDbType 显式指定类型比靠推断更稳,尤其对 CLOBDATENUMBER 等易出错类型。

Difeye-敏捷的轻量级PHP框架
Difeye-敏捷的轻量级PHP框架

Difeye是一款超轻量级PHP框架,主要特点有: Difeye是一款超轻量级PHP框架,主要特点有: ◆数据库连接做自动主从读写分离配置,适合单机和分布式站点部署; ◆支持Smarty模板机制,可灵活配置第三方缓存组件; ◆完全分离页面和动作,仿C#页面加载自动执行Page_Load入口函数; ◆支持mysql,mongodb等第三方数据库模块,支持读写分离,分布式部署; ◆增加后台管理开发示例

下载
  • 参数名必须带冒号:cmd.Parameters.Add(new OracleParameter(":id", 123)),写成 "id""@id" 都会报 ORA-01036
  • 查询含中文或特殊字符时,确保数据库字符集(如 AL32UTF8)与客户端一致,否则 GetString() 可能乱码
  • OracleCommand.CommandTimeout 默认是 30 秒,长查询记得调大,否则超时后连接可能未释放

连接池默认开启,但要注意泄漏和状态残留

Oracle.ManagedDataAccess 默认启用连接池,这很好,但容易掩盖 Connection 忘记 Close()Dispose() 的问题。连接池里的物理连接不会立刻关闭,而是回收复用 —— 表面看程序跑得动,实际可能耗尽池子(默认上限 100)。

典型症状:应用运行一段时间后,新请求卡住、超时,日志里反复出现 ORA-12519: no appropriate service handler foundTimeout expired

  • 务必用 using 块包裹 OracleConnectionOracleCommand
  • 不要手动调用 ClearAllPools() 除非真有连接状态污染(如 ALTER SESSION),它会强制所有连接重连,伤性能
  • 可通过连接字符串加 Pooling=true;Min Pool Size=5;Max Pool Size=50; 控制池行为

最常被忽略的是连接字符串里混用了不同用户、不同服务名但共用同一个连接池键 —— ODP.NET 会把它们当同一池,导致权限或 schema 错乱。每个独立业务场景建议用唯一连接字符串,或显式关池:Pooling=false(仅调试用)。

相关专题

更多
数据类型有哪几种
数据类型有哪几种

数据类型有整型、浮点型、字符型、字符串型、布尔型、数组、结构体和枚举等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

295

2023.10.31

php数据类型
php数据类型

本专题整合了php数据类型相关内容,阅读专题下面的文章了解更多详细内容。

216

2025.10.31

session失效的原因
session失效的原因

session失效的原因有会话超时、会话数量限制、会话完整性检查、服务器重启、浏览器或设备问题等等。详细介绍:1、会话超时:服务器为Session设置了一个默认的超时时间,当用户在一段时间内没有与服务器交互时,Session将自动失效;2、会话数量限制:服务器为每个用户的Session数量设置了一个限制,当用户创建的Session数量超过这个限制时,最新的会覆盖最早的等等。

302

2023.10.17

session失效解决方法
session失效解决方法

session失效通常是由于 session 的生存时间过期或者服务器关闭导致的。其解决办法:1、延长session的生存时间;2、使用持久化存储;3、使用cookie;4、异步更新session;5、使用会话管理中间件。

704

2023.10.18

cookie与session的区别
cookie与session的区别

本专题整合了cookie与session的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

88

2025.08.19

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

247

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

204

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1434

2023.10.24

excel制作动态图表教程
excel制作动态图表教程

本专题整合了excel制作动态图表相关教程,阅读专题下面的文章了解更多详细教程。

30

2025.12.29

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
SQL 教程
SQL 教程

共61课时 | 3.2万人学习

Java 教程
Java 教程

共578课时 | 39.3万人学习

oracle知识库
oracle知识库

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号