基于Oracle Native Client 12的C#应用Oracle 12c连接字符串需求

阿华AIGC实验室

2026-5-26

针对你的C#连接Oracle 12c的需求，结合你已安装的完整版Oracle Native Client 12.02.00.01，我整理了两种实用的连接方案，涵盖直接构建连接字符串和配置TNS别名两种场景：

方式1：直接构建连接字符串（无需修改tnsnames.ora）

这种方式不需要改动客户端的tnsnames.ora配置，直接将用户提供的主机、端口、服务名等参数嵌入连接字符串，适合动态获取用户输入的场景。

你可以用OracleConnectionStringBuilder来规范构建连接字符串，避免手动拼接的错误：

using Oracle.DataAccess.Client; // 记得引用Oracle.DataAccess.dll（来自Oracle Native Client安装目录）

// 替换成用户输入的实际参数
string host = "用户提供的主机地址";
int port = int.Parse("用户提供的端口");
string serviceName = "用户提供的服务名";
string username = "用户提供的用户名";
string password = "用户提供的密码";

var connStringBuilder = new OracleConnectionStringBuilder();
// 直接拼接数据源描述
connStringBuilder.DataSource = $"(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST={host})(PORT={port}))(CONNECT_DATA=(SERVICE_NAME={serviceName})))";
connStringBuilder.UserId = username;
connStringBuilder.Password = password;

// 生成最终的连接字符串
string connectionString = connStringBuilder.ToString();

// 示例使用
using (var oracleConn = new OracleConnection(connectionString))
{
    oracleConn.Open();
    // 这里执行你的数据库操作...
}

注意： 这种方式的优势是无需修改客户端配置，灵活性高，适合每次连接参数可能变化的场景。

方式2：配置TNS别名后使用别名连接

如果需要复用某个服务器的连接配置，或者用户更习惯使用TNS别名，你可以修改客户端的tnsnames.ora文件添加别名配置，之后用别名简化连接字符串。

步骤1：找到tnsnames.ora的位置

一般位于Oracle Native Client安装目录的network\admin文件夹下，比如：
C:\app\client\你的Windows用户名\product\12.2.0\client_1\network\admin\tnsnames.ora

步骤2：添加TNS别名配置

打开tnsnames.ora，追加类似下面的配置（替换成用户提供的实际参数）：

# 这里的somealias是自定义的别名，用户可以自己命名
somealias =
  (DESCRIPTION =
    (ADDRESS_LIST =
      (ADDRESS = (PROTOCOL = TCP)(HOST = 用户提供的主机地址)(PORT = 用户提供的端口))
    )
    (CONNECT_DATA =
      (SERVICE_NAME = 用户提供的服务名)
    )
  )

步骤3：用TNS别名构建连接字符串

配置完成后，连接字符串可以简化为使用别名：

using Oracle.DataAccess.Client;

var connStringBuilder = new OracleConnectionStringBuilder();
connStringBuilder.DataSource = "somealias"; // 这里用刚才配置的TNS别名
connStringBuilder.UserId = "用户提供的用户名";
connStringBuilder.Password = "用户提供的密码";

string connectionString = connStringBuilder.ToString();

// 示例使用
using (var oracleConn = new OracleConnection(connectionString))
{
    oracleConn.Open();
    // 执行数据库操作...
}