在C#项目中对接Oracle数据库是很多企业级开发场景下的常见需求，通过ADO.NET相关的驱动组件，我们可以快速实现与Oracle数据库的交互，完成数据的查询、新增、修改、删除等操作。
环境准备
在开始编写代码前，需要先完成以下环境配置：
- 安装Oracle数据库服务端或者确保可以访问远程Oracle数据库实例，记录数据库的服务名、主机地址、端口、用户名和密码
- 在C#项目中安装Oracle驱动，目前常用的驱动是Oracle.ManagedDataAccess，这是Oracle官方提供的托管驱动，不需要额外安装Oracle客户端，直接在NuGet中搜索安装即可
- 确保项目的.NET框架版本和驱动兼容，Oracle.ManagedDataAccess支持.NET Framework 4及以上版本和.NET Core/.NET 5+版本
配置连接字符串
连接Oracle数据库需要正确的连接字符串，常见的连接字符串格式如下：
// 基础连接字符串格式，替换为实际的数据库信息 string connectionString = "User Id=用户名;Password=密码;Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=数据库主机地址)(PORT=端口))(CONNECT_DATA=(SERVICE_NAME=服务名)));";
如果使用的是简化格式，也可以直接写成如下形式：
// 简化连接字符串，适用于部分环境 string connectionString = "User Id=用户名;Password=密码;Data Source=主机地址:端口/服务名;";
基础连接与查询操作实例
下面演示如何使用OracleConnection和OracleCommand完成数据库查询操作：
using Oracle.ManagedDataAccess.Client;
using System;
namespace OracleConnectDemo
{
class Program
{
static void Main(string[] args)
{
// 连接字符串，替换为实际配置
string connStr = "User Id=scott;Password=tiger;Data Source=127.0.0.1:1521/orcl;";
// 创建连接对象
using (OracleConnection conn = new OracleConnection(connStr))
{
try
{
// 打开数据库连接
conn.Open();
Console.WriteLine("Oracle数据库连接成功");
// 创建命令对象，执行查询语句
string sql = "SELECT EMPNO, ENAME FROM EMP WHERE ROWNUM <= 5";
using (OracleCommand cmd = new OracleCommand(sql, conn))
{
// 执行查询，获取读取器
using (OracleDataReader reader = cmd.ExecuteReader())
{
// 遍历结果集
while (reader.Read())
{
Console.WriteLine($"员工编号：{reader["EMPNO"]}，员工姓名：{reader["ENAME"]}");
}
}
}
}
catch (Exception ex)
{
Console.WriteLine($"操作失败，错误信息：{ex.Message}");
}
finally
{
// 关闭连接，using语句会自动释放资源，这里可以省略手动关闭
if (conn.State == System.Data.ConnectionState.Open)
{
conn.Close();
}
}
}
}
}
}
增删改操作实例
除了查询操作，新增、修改、删除操作可以通过ExecuteNonQuery方法完成，下面是新增数据的示例：
using Oracle.ManagedDataAccess.Client;
using System;
namespace OracleInsertDemo
{
class Program
{
static void Main(string[] args)
{
string connStr = "User Id=scott;Password=tiger;Data Source=127.0.0.1:1521/orcl;";
using (OracleConnection conn = new OracleConnection(connStr))
{
try
{
conn.Open();
// 新增数据的SQL语句，使用参数化避免SQL注入
string insertSql = "INSERT INTO EMP (EMPNO, ENAME, JOB) VALUES (:empNo, :ename, :job)";
using (OracleCommand cmd = new OracleCommand(insertSql, conn))
{
// 添加参数，Oracle参数名以冒号开头
cmd.Parameters.Add(new OracleParameter(":empNo", 1234));
cmd.Parameters.Add(new OracleParameter(":ename", "测试员工"));
cmd.Parameters.Add(new OracleParameter(":job", "开发工程师"));
// 执行新增操作，返回受影响的行数
int rows = cmd.ExecuteNonQuery();
Console.WriteLine($"新增成功，受影响行数：{rows}");
}
}
catch (Exception ex)
{
Console.WriteLine($"新增失败，错误信息：{ex.Message}");
}
}
}
}
}
常见问题说明
- 连接时报TNS错误：通常是连接字符串中的服务名、主机地址或者端口配置错误，需要核对数据库的实际配置信息
- 驱动冲突：如果项目中同时安装了多个Oracle驱动，可能会出现类型冲突，建议只保留Oracle.ManagedDataAccess一个驱动
- 参数化查询：操作Oracle时参数名需要以冒号开头，和SQL Server的参数前缀不同，需要注意区分
总结
通过上述步骤，我们可以完成C#连接Oracle数据库的全流程操作，核心是先配置正确的连接字符串，再通过ADO.NET的标准组件完成交互。实际开发中建议尽量使用参数化查询，避免SQL注入风险，同时做好异常捕获和资源释放，保证程序的稳定性。
C#Oracle连接ADO.NETOracleClient数据库操作修改时间：2026-06-14 22:30:32