【下载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,并且您当前关注的是表单设计器。
- 打开Toolbox,在Dotconnect for Oracle类别中找到OracleConnection组件。
- 双击组件。请注意,新对象显示在窗体下的设计器上。如果这是第一次在此应用程序中创建OracleConnection,则将其命名为OracleConnection1。
- 单击OracleConnection1对象,然后按F4键以关注对象的属性。
- 如果通过OCI连接,请在Server属性中提供服务器的TNS别名。
- 如果使用直接模式,请执行以下分配:
- 设置Direct为true
- 在Server属性中,提供Oracle服务器所在计算机的DNS名称或IP地址
- 在sid属性中提供服务名称
- 在Port属性中,指定服务器监听的端口(通常是1521)。
- 在userid属性中指定您的登录名。例如,scott。
- 在Password属性中指定密码。例如,tiger。
- 注意,当您为这些属性分配值时,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 |
|
1 2 3 4 5 6 |
|
你可以在一个任务中完成这一切。实际上,连接字符串是直接分配的还是由特定属性组成的并不重要。将值赋给ConnectionString属性后,所有其他属性都将填充已分析的值。所以你可以选择对你更方便的。
1 |
|
1 |
|
使用连接字符串生成器
如果决定通过为多个属性赋值来设置连接,请考虑使用OracleConnectionStringBuilder类。它将所有可能的连接设置公开为属性,从而允许您完全自定义连接。下面的示例演示如何组合更复杂的连接字符串:
1 2 3 4 5 6 7 8 9 10 |
|
1 2 3 4 5 6 7 8 9 10 |
|
注意,在这个示例中,我们使用了接受连接字符串作为参数的OracleConnection构造函数。
打开连接
打开连接非常简单:
1 |
|
1 |
|
当然,OracleConnection1前面必须指定有效的连接字符串。调用open时,dotconnect for oracle尝试查找主机并连接到服务器。如果出现任何问题,它会引发一个异常,并简要说明出了什么问题。如果没有遇到问题,则dotconnect for oracle会在connectionTimeout间隔期间尝试建立连接。最后,当建立连接时,open方法返回,状态属性更改为open。
在设计阶段,您可以通过以下几个步骤连接到服务器:
- 右键单击Designer中的OracleConnection1对象。
- 从弹出菜单中选择“Connect”。
- 在对话框窗口中提供必要的登录信息。
- 单击“Connect”按钮以建立连接。
或者,您可以简单地将State属性更改为在“Open”窗口中打开,以使用当前连接字符串建立连接。
闭合连接
若要关闭连接,请调用其Close方法,或将其State属性设置为Closed。
下面的示例总结了上述信息,并显示了如何创建、设置、打开、使用和关闭连接。
1 2 3 4 5 |
|
1 2 3 4 5 |
|
示例代码连接到服务器,显示其版本,然后关闭连接。这实际上是很少使用的,因为在实际应用程序中,连接被其他对象使用,如oraclecommand、oracledatatable和其他对象。
修改连接
您可以通过更改OracleConnection对象的属性来修改连接。请记住,虽然某些属性可以自由更改,但在分配新值时,大多数属性都会关闭连接。例如,如果更改服务器属性,它将立即关闭,并且必须手动重新打开它。
附加信息
Dotconnect for Oracle有许多您可以利用的功能,您可以探索高级技术,以获得更好的性能、平衡网络负载或启用其他功能。