dotConnect for Oracle入门指南（二）：登录到服务器

【下载dotConnect for Oracle最新版本】

dotConnect for Oracle(原名OraDirect.NET)建立在ADO.NET技术上，为基于Oracle数据库的应用程序提供完整的解决方案。它为设计应用程序结构带来了新的方法，提高工作效率，使数据库应用程序的开发更简便。

本教程介绍如何连接到Oracle服务器。

本教程包含：

• 要求
• 一般信息
• 创建OracleConnection
• 打开连接
• 闭合连接
• 修改连接
• 附加信息

要求

为了连接到Oracle服务器，需要运行服务器本身，安装dotConnect for Oracl并运行IDE。如果您安装了Oracle客户机软件并想使用它，您需要知道TNS别名、登录名和密码。如果您不想使用OCI，您必须知道主机名或IP地址、SID（或servicename）、端口、登录名和密码。

请注意，如果不使用设计时（特别是，如果不将工具箱中的OracleConnection组件放在表单设计器上），则必须手动嵌入许可信息。

一般信息

要建立到服务器的连接，您必须为dotConnect for Oracle提供一些连接参数。OracleConnection组件使用此信息查找服务器并使用您帐户的凭据登录。这些参数表示为连接字符串。您可以手动组合连接字符串，也可以让Dotconnect for Oracle为您构造连接字符串。

连接到服务器有两种方法：使用和不使用Oracle客户端接口。这由直接属性控制。它指示是否将使用Oracle客户端接口连接到服务器。默认情况下，禁用直接模式以保留最大功能。如果要在未安装Oracle客户端软件的系统中工作，请切换到直接模式。

注意：要使用OCI模式，您的Oracle客户端必须与您的应用程序具有相同的位。对于32位应用程序，必须安装32位Oracle客户端；对于64位应用程序，必须安装64位Oracle客户端。

创建OracleConnection

设计时创建

请注意，此处描述的设计时连接创建仅适用于用于完整.NET框架的Windows窗体应用程序。

下面假设您正在运行IDE，并且您当前关注的是表单设计器。

1. 打开Toolbox，在Dotconnect for Oracle类别中找到OracleConnection组件。
2. 双击组件。请注意，新对象显示在窗体下的设计器上。如果这是第一次在此应用程序中创建OracleConnection，则将其命名为OracleConnection1。
3. 单击OracleConnection1对象，然后按F4键以关注对象的属性。
4. 如果通过OCI连接，请在Server属性中提供服务器的TNS别名。
5. 如果使用直接模式，请执行以下分配：
   • 设置Direct为true
   • 在Server属性中，提供Oracle服务器所在计算机的DNS名称或IP地址
   • 在sid属性中提供服务名称
   • 在Port属性中，指定服务器监听的端口（通常是1521）。
6. 在userid属性中指定您的登录名。例如，scott。
7. 在Password属性中指定密码。例如，tiger。
8. 注意，当您为这些属性分配值时，ConnectionString属性会自动更新以反映您的设置。现在它包含一些类似于User Id=scott;Password=tiger;Server=OraServer; （例如oci模式）。

运行时创建

运行时执行的相同操作如下所示（请注意，您必须为完整的.NET框架添加对Devart.Data.Oracle.dll和Devart.Data.dll程序集的引用，或者为.NET核心安装devart.data.oracle nuget包）：

using Devart.Data.Oracle;
...
OracleConnection oracleConnection1 = new OracleConnection();
oracleConnection1.Server = "OraServer";
oracleConnection1.UserId = "scott";
oracleConnection1.Password = "tiger";

Imports Devart.Data.Oracle
...
Dim OracleConnection1 As OracleConnection = New OracleConnection()
OracleConnection1.Server = "OraServer"
OracleConnection1.UserId = "scott"
OracleConnection1.Password = "tiger"

你可以在一个任务中完成这一切。实际上，连接字符串是直接分配的还是由特定属性组成的并不重要。将值赋给ConnectionString属性后，所有其他属性都将填充已分析的值。所以你可以选择对你更方便的。

oracleConnection1.ConnectionString = "User Id=scott;Password=tiger;Server=OraServer;";

oracleConnection1.ConnectionString = "User Id=scott;Password=tiger;Server=OraServer;"

使用连接字符串生成器

如果决定通过为多个属性赋值来设置连接，请考虑使用OracleConnectionStringBuilder类。它将所有可能的连接设置公开为属性，从而允许您完全自定义连接。下面的示例演示如何组合更复杂的连接字符串：

OracleConnectionStringBuilder oraCSB = new OracleConnectionStringBuilder();
oraCSB.Direct = true;
oraCSB.Server = "192.168.0.1";
oraCSB.Port = 1251;
oraCSB.Sid = "OracleSid";
oraCSB.UserId = "scott";
oraCSB.Password = "tiger";
oraCSB.MaxPoolSize = 150;
oraCSB.ConnectionTimeout = 30;
OracleConnection myConnection = new OracleConnection(oraCSB.ConnectionString);

Dim oraCSB As OracleConnectionStringBuilder = New OracleConnectionStringBuilder
oraCSB.Direct = true
oraCSB.Server = "192.168.0.1"
oraCSB.Port = 1251
oraCSB.Sid = "OracleSid"
oraCSB.UserId = "scott"
oraCSB.Password = "tiger"
oraCSB.MaxPoolSize = 150
oraCSB.ConnectionTimeout = 30
Dim myConnection As OracleConnection = New OracleConnection(oraCSB.ConnectionString)

注意，在这个示例中，我们使用了接受连接字符串作为参数的OracleConnection构造函数。

打开连接

打开连接非常简单：

oracleConnection1.Open();

OracleConnection1.Open()

当然，OracleConnection1前面必须指定有效的连接字符串。调用open时，dotconnect for oracle尝试查找主机并连接到服务器。如果出现任何问题，它会引发一个异常，并简要说明出了什么问题。如果没有遇到问题，则dotconnect for oracle会在connectionTimeout间隔期间尝试建立连接。最后，当建立连接时，open方法返回，状态属性更改为open。

在设计阶段，您可以通过以下几个步骤连接到服务器：

1. 右键单击Designer中的OracleConnection1对象。
2. 从弹出菜单中选择“Connect”。
3. 在对话框窗口中提供必要的登录信息。
4. 单击“Connect”按钮以建立连接。

或者，您可以简单地将State属性更改为在“Open”窗口中打开，以使用当前连接字符串建立连接。

闭合连接

若要关闭连接，请调用其Close方法，或将其State属性设置为Closed。

下面的示例总结了上述信息，并显示了如何创建、设置、打开、使用和关闭连接。

OracleConnection myConn = new OracleConnection();
myConn.ConnectionString = "User Id=scott;Password=tiger;Server=OraServer;";
myConn.Open();
MessageBox.Show(myConn.ServerVersion);
myConn.Close();

Dim myConn As OracleConnection = New OracleConnection()
myConn.ConnectionString = "User Id=scott;Password=tiger;Server=OraServer;"
myConn.Open()
MessageBox.Show(myConn.ServerVersion)
myConn.Close()

示例代码连接到服务器，显示其版本，然后关闭连接。这实际上是很少使用的，因为在实际应用程序中，连接被其他对象使用，如oraclecommand、oracledatatable和其他对象。

修改连接

您可以通过更改OracleConnection对象的属性来修改连接。请记住，虽然某些属性可以自由更改，但在分配新值时，大多数属性都会关闭连接。例如，如果更改服务器属性，它将立即关闭，并且必须手动重新打开它。

附加信息

Dotconnect for Oracle有许多您可以利用的功能，您可以探索高级技术，以获得更好的性能、平衡网络负载或启用其他功能。