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包）：

1 2 3 4 5 6

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

1 2 3 4 5 6

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

你能够在一个任务中完成这一切。实际上，链接字符串是直接分配的仍是由特定属性组成的并不重要。将值赋给ConnectionString属性后，全部其余属性都将填充已分析的值。因此你能够选择对你更方便的。

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

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

使用链接字符串生成器

若是决定经过为多个属性赋值来设置链接，请考虑使用OracleConnectionStringBuilder类。它将全部可能的链接设置公开为属性，从而容许您彻底自定义链接。下面的示例演示如何组合更复杂的链接字符串：

1 2 3 4 5 6 7 8 9 10

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);

1 2 3 4 5 6 7 8 9 10

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构造函数。

打开链接

打开链接很是简单：

1	oracleConnection1.Open();

1	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。

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

1 2 3 4 5

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

1 2 3 4 5

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有许多您能够利用的功能，您能够探索高级技术，以得到更好的性能、平衡网络负载或启用其余功能。