在Oracle上构建 .NET 应用程序
2024-07-10 13:11:50
供稿：网友
了解构建使用 oracle 数据库的 .net 应用程序所涉及到的基本但不可或缺的过程
本文涉及的下载
· 示例代码
· oracle data provider for .net (odp.net)
随着 microsoft 的 .net 框架的逐渐流行，许多开发人员迫切想了解关于将 .net 应用程序与 oracle 集成的最好的方式的信息 — 不仅在基本的连通性方面，还包括与使用 visual studio.net (vs.net) 进行有效的应用程序开发的关系。
在本文中，我将说明构建使用 oracle 数据库的 .net 应用程序所涉及到的基本但不可或缺的过程，包括：
如何添加工程引用，以在您的 .net 工程中支持 oracle 类
如何创建 oracle 数据库连接字符串
如何使用 connection、command 和 datareader 对象。
您将有机会应用您在三个上机操作实践中学到的内容，难度范围从比较容易到更复杂。
.net data provider
除了基本的 oracle 客户端连通性软件，.net 应用程序还需要使用称为 managed data provider（其中 "managed" 指的是代码由 .net 框架管理）的工具。 数据供应程序是 .net 应用程序代码和 oracle 客户端连通性软件之间的层。 在几乎所有情况下，最优的性能都是通过使用为特定数据库平台优化了的供应程序而不是一般的 .net ole db 数据供应程序实现的。
oracle、microsoft 和第三方供应商都提供了针对 oracle 产品进行了优化的数据供应程序。 oracle 和 microsoft 免费提供其 oracle 数据供应程序。 （microsoft 为 .net 框架的 1.1 版提供的供应程序包含在该框架中，不需要单独下载或安装。） 一些第三方数据供应程序支持 oracle 的较早的版本，或者不需要安装 oracle 客户端软件。 在本文中，我们假设使用 oracle data provider for .net (odp.net)，并单独提供下载。
当安装了 odp.net 和所有要求的 oracle 客户端连通性软件时，就可以开始使用 visual studio.net 进行应用程序开发了。 在开始开发前，请先确认客户端连通性。 如果您在 vs.net 所在的计算机上使用 sql*plus 能够与 oracle 连接，那么证明您已经正确地安装和配置了 oracle 客户端软件。
如果您刚接触 oracle，那么请参阅 oracle data provider for .net 开发人员指南 10g 版本 1 (10.1) 中的“与 oracle 数据库连接”部分，以了解 odp.net 的背景信息，或参阅 oracle 数据库管理员指南 10g 版本 1 (10.1)，以了解关于管理 oracle 数据库的通用信息。 您还可以查阅“使用 odp.net 与 oracle 数据库连接”示例代码“方法”文档。
在 visual studio.net 中创建工程
在启动 vs.net 之后，第一个任务是创建一个工程。 您可以单击 new project 按钮或选择 file | new | project...。
出现一个 new project 对话框。 在对话框左侧的 project types 下，选择您的编程语言。 在这个例子中，我们选择 vb.net。 在右侧的 templates 下，选择一个工程模板。 为简单起见，这里选择 windows application。
您将需要为工程（我们使用 otnwinapp）和解决方案（我们使用 otnsamples）指定有意义的名称。 一个解决方案包含一个或多个工程。 当一个解决方案仅包含一个工程时，许多人对二者使用相同的名称。
添加引用
因为我们的工程必须与 oracle 数据库连接，因此必须添加一个到包含我们选择的数据供应程序的 dll 的引用。 在 solution explorer 内，选择 references 节点，右键单击并选择 add reference。 或者，您可以转至菜单栏并选择 project，然后选择 add reference。
出现 add reference 对话框。
从列表中选择 oracle.dataaccess.dll，然后单击 select 按钮，最后单击 ok 按钮，使您的工程能够找到 odp.net 数据供应程序。
vb.net/c# 语句
在添加引用之后，标准的做法是要添加 vb.net imports 语句、c# using 语句或 j# import 语句。 从技术上说这些语句不是必要的，但是使用它们可以让您不需用冗长且完整名称来引用数据库对象。
按照惯例，这些语句出现在代码文件的顶部或顶部附近，在命名空间或类声明之前。
imports system.data ' vb.netimports oracle.dataaccess.client ' odp.net oracle managed providerusing system.data; // c#using oracle.dataaccess.client; // odp.net oracle managed providerimport system.data.*; // j#import oracle.dataaccess.client; // odp.net oracle managed provider
连接字符串和对象
oracle 连接字符串和 oracle 名称解析是不可分的。 假定我们在 tnsnames.ora 文件中定义了一个数据库别名 oradb，如下：
oradb= (description= (address_list= (address=(protocol=tcp)(host=otnsrvr)(port=1521)) ) (connect_data= (server=dedicated) (service_name=orcl) ) )
要使用上面所述的在 tnsnames.ora 文件中定义的 oradb 别名，您需要使用以下语法：
dim oradb as string = "data source=oradb;user id=scott;password=tiger;" ' vb.netstring oradb = "data source=oradb;user id=scott;password=tiger;"; // c#
不过，您可以修改连接字符串，这样就不需用 tnsnames.ora 文件。 只需用在 tnsnames.ora 文件中定义别名的语句替换别名即可。
' vb.net dim oradb as string = "data source=(description=" _ + "(address_list=(address=(protocol=tcp)(host=otnsrvr)(port=1521)))" _ + "(connect_data=(server=dedicated)(service_name=orcl)));" _ + "user id=scott;password=tiger;"string oradb = "data source=(description=" // c# + "(address_list=(address=(protocol=tcp)(host=otnsrvr)(port=1521)))" + "(connect_data=(server=dedicated)(service_name=orcl)));" + "user id=scott;password=tiger;";
正如您在上面看到的那样，用户名和口令是以不加密的文本形式嵌入到连接字符串中的。 这是创建连接字符串的最简单的方法。 然而，从安全的角度而言不加密文本的方法是不可取的。 而且，您需要了解编译的 .net 应用程序代码仅比不加密文本形式的源代码文件稍微安全一点。 可以非常简便的反编译 .net dll 和 exe 文件，进而查看原始的不加密文本形式的内容。 （加密实际上是正确的解决方案，但这个主题与我们这里的讨论相差太远。）
接下来，您必须从连接类中完成一个连接对象的实例化。 连接字符串必须与连接对象关联。
dim conn as new oracleconnection(oradb) ' vb.netoracleconnection conn = new oracleconnection(oradb); // c#
注意，通过将连接字符串传递给连接对象的构造器（该构造器进行了重载），连接字符串与连接对象建立关联。 构造函数的其他重载允许以下这些替代的语法：
dim conn as new oracleconnection() ' vb.netconn.connectionstring = oradboracleconnection conn = new oracleconnection(); // c#conn.connectionstring = oradb;
在连接字符串与连接对象建立关联之后，使用 open 方法来创建实际的连接。
conn.open() ' vb.netconn.open(); // c#
我们将在稍后介绍错误处理。
command 对象
command 对象用于指定执行的 sql 命令文本 — sql 字符串或存储过程。 类似于 connection 对象，它必须从完成其类的实例化，并且它拥有一个重载的构造函数。
dim sql as string = "select dname from dept where deptno = 10" ' vb.netdim cmd as new oraclecommand(sql, conn)cmd.commandtype = commandtype.textstring sql = "select dname from dept where deptno = 10"; // c#oraclecommand cmd = new oraclecommand(sql, conn);cmd.commandtype = commandtype.text;
不同的重载，语法的结构稍微有点不同。 command 对象有用于执行命令文本的方法。 不同的方法适用于不同类型的 sql 命令。
检索标量值
从数据库中检索数据可以通过实例化一个 datareader 对象并使用 executereader 方法（它返回一个 oracledatareader 对象）来实现。 通过将列名称或以零为基数的列序号传递给项属性 b.net 开发人员可以访问返回的数据。 另一种选择是使用存取程序类型方法来返回列数据。
dim dr as oracledatareader = cmd.executereader() ' vb.netdr.read()label1.text = dr.item("dname") ' retrieve by column namelabel1.text = dr.item(0) ' retrieve the first column in the select listlabel1.text = dr.getstring(0) ' retrieve the first column in the select list
c# 开发人员必须使用存取器方法来检索数据。 有适当类型的存取程序用于返回 .net 本地数据类型，其他的存取程序用于返回本地 oracle 数据类型。 以零为基数的序号被传递给存取程序，以指定返回哪一列。
oracledatareader dr = cmd.executereader(); // c#dr.read();label1.text = dr.getstring(0); // c# retrieve the first column in the select list
在这个简化的例子中，dname 的返回值是一个字符串，它用来设置标签控件的文本的属性值（也是一个字符串）。 但如果检索的是 deptno，而不是字符串，那么将出现数据类型不匹配的情况。 当源数据类型与目标数据类型不匹配时，.net 运行时将尝试隐式地转换数据类型。 有时数据类型不兼容，则隐式转换将失败，并跳出一个异常警报。 但即使可以进行隐式转换，使用显式数据类型转换仍比用隐式数据类型转换好。
到整型的显式转换显示如下：
label1.text = cstr(dr.item("deptno")) ' vb.net integer to string cast
在隐式转换上,c# 的容错能力不如 vb.net。 您必须自己执行显式转换：
string deptno = dr.getint16("deptno").tostring(); // c#
您可以显式地转换标量值以及数组。
关闭并清除
可以调用连接对象的 close 方法或 dispose 方法来关闭到数据库的连接。 dispose 方法调用 close 方法。
conn.close() ' vb.netconn.dispose() ' vb.netconn.close(); // c#conn.dispose(); // c#
作为可选项，c# 提供了一种在连接超出范围时自动清除连接的特殊语法。 使用 using 关键字可启用这一特性。
using (oracleconnection conn = new oracleconnection(oradb)){conn.open();oraclecommand cmd = new oraclecommand(); cmd.connection = conn; cmd.commandtext = "select dname from dept where deptno = 10";cmd.commandtype = commandtype.text; oracledatareader dr = cmd.executereader(); dr.read(); label1.text = dr.getstring(0);}
您可以试验在上机操作 1（从数据库中检索数据）和上机操作 2（增加交互性）中学到的一些概念。
错误处理
try-catch-finally 结构的错误处理是 .net 语言的一部分。 下面是使用 try-catch-finally 语法的一个相对最小的例子：
dim conn as new oracleconnection(oradb) ' vb.nettry conn.open() dim cmd as new oraclecommand cmd.connection = conn cmd.commandtext = "select dname from dept where deptno = " + textbox1.textcmd.commandtype = commandtype.text if dr.read() then label1.text = dr.item("dname") ' or use dr.item(0) end ifcatch ex as exception ' catches any error messagebox.show(ex.message.tostring())finally conn.dispose()end tryoracleconnection conn = new oracleconnection(oradb); // c#try{conn.open();oraclecommand cmd = new oraclecommand(); cmd.connection = conn; cmd.commandtext = "select dname from dept where deptno = " + textbox1.text;cmd.commandtype = commandtype.text; if (dr.read()) // c# { label1.text = dr.getstring(0); }}catch (exception ex) // catches any error{ messagebox.show(ex.message.tostring());}finally{ conn.dispose();}
虽然这种方法将适当地捕获尝试从数据库中获取数据时发生的任何错误，但这种方法对用户却不友好。
oracle dba 或开发人员很清楚 ora-12545 的意义，但是最终用户不清楚。 一种更好的解决方案是添加一条额外的 catch 语句来捕获最常见的数据库错误并显示对用户友好的消息。
catch ex as oracleexception ' catches only oracle errors if instr(1, ex.message.tostring(), "ora-1:", comparemethod.text) then messagebox.show("error attempting to insert duplicate data.") elseif instr(1, ex.message.tostring(), "ora-12545:", comparemethod.text) then messagebox.show("the database is unavailable.") else messagebox.show("database error: " + ex.message.tostring()) end ifcatch ex as exception ' catches any error messagebox.show(ex.message.tostring())catch (oracleexception ex) // catches only oracle errors{ switch (ex.number) {case 1: messagebox.show("error attempting to insert duplicate data."); break; case 12545: messagebox.show("the database is unavailable."); break; default: messagebox.show("database error:" + ex.message.tostring()); break; }}catch (exception ex) // catches any error{ messagebox.show(ex.message.tostring());}
注意上面的代码示例中的两条 catch 语句。 如果没有捕获到任何 oracle 错误，那么将跳过第一条 catch 语句分支，让第二条 catch 语句来捕获其他任何类型的错误。 在代码中，应该根据从特殊到一般的顺序对 catch 语句排序。 在实施了对用户友好的异常处理代码之后，ora-12545 错误消息
finally 代码将始终执行，而无论错误是否发生。 通过在 finally 代码块中加入连接对象的 close 或 dispose 方法调用，在执行了 try-catch-finally 代码段之后，数据库连接将始终关闭。 试图关闭没有打开的数据库连接不会导致错误。 例如，如果数据库不可用，数据库连接没有打开，那么 finally 代码块将试图关闭不存在的连接。 执行多余的 close 或 dispose 是无效的。 只需将一条 close 或 dispose 方法放到 finally 代码块中，将保证关闭连接。
利用 datareader 检索多个值
到目前为止，我们的示例仅说明了如何检索单个值。 datareader 可以检索多列和多行的值。 首先进行多行、单列的查询：
select deptno, dname, loc from dept where deptno = 10
要获取列的值，可以使用以零为基数的序号或列名。 序号与查询中的顺序相关。 因而，可以在 vb.net 中通过使用 dr.item(2) 或 dr.item("loc") 来查询 loc 列的值。
下面是将 dname 和来自上一查询的 loc 列串连起来的代码段：
label1.text = "the " + dr.item(1) + " department is in " + dr.item("loc") ' vb.netlabel1.text = "the " + dr.getstring(1) + " department is in " + dr.getstring(2); // c#
现在我们进行返回多行的查询：
select deptno, dname, loc from dept
要处理从 datareader 中返回的多行，需要某种类型的循环结构。 此外，需要一个可以显示多行的控件。 datareader 是一个仅正向的只读游标，因此不能将其与可更新或完全可滚动的控件（如 windows forms datagrid 控件）捆绑在一起。 datareader 与 listbox 控件兼容，如以下代码段所示：
while dr.read() ' vb.net listbox1.items.add("the " + dr.item(1) + " department is in " + dr.item("loc")) end whilewhile (dr.read()) // c#{ listbox1.items.add("the " + dr.getstring(1) + " department is in " + dr.getstring(2);}
上机操作 3（利用 datareader 检索多列和多行)重点介绍了这些概念中的一部分。
总结
本文向您介绍了使用 vs.net 编程语言访问 oracle 数据库的过程。 您现在应该能够连接数据库并检索多列和多行。
john paul cook ([email protected]) 是居住在休斯顿的一位数据库和 .net 顾问。 他撰写了许多关于 .net、oracle 和其他主题的文章，并从 1986 年以来一直开发关系数据库应用程序。他目前的兴趣包括 visual studio 2005 和 oracle 10g。 他是 oracle 认证 dba 和 microsoft mcsd for .net。
上机操作 1： 从数据库中检索数据
首先向 windows 表单添加一个按钮控件和一个标签控件。 务必在这些控件上方保留空间，以便在上机操作 2 中添加控件。
添加代码，它们用于从 oracle 数据库中检索数据并在表单上显示结果。 将代码放在按钮的单击事件处理程序中。 开始这项任务的最容易的方式是双击该按钮，因为它将为事件处理程序创建一个 stub。
在 public class 声明之前添加 vb.net imports 语句，或在命名空间声明之前添加 c# using 语句。
imports system.data ' vb.netimports oracle.dataaccess.client ' odp.net oracle managed providerusing system.data; // c#using oracle.dataaccess.client; // odp.net oracle managed provider
在 private sub 和 end sub 语句之间添加 vb.net 版本 事件语句代码（确保用您的服务器的主机名称替代 otnsrvr）：
dim oradb as string = "data source=(description=(address_list=" _ + "(address=(protocol=tcp)(host=otnsrvr)(port=1521)))" _ + "(connect_data=(server=dedicated)(service_name=orcl)));" _ + "user id=scott;password=tiger;"dim conn as new oracleconnection(oradb) ' vb.netconn.open()dim cmd as new oraclecommandcmd.connection = conncmd.commandtext = "select dname from dept where deptno = 10"cmd.commandtype = commandtype.textdim dr as oracledatareader = cmd.executereader()dr.read()label1.text = dr.item("dname") ' or dr.item(0)conn.dispose()
将以下 c# 代码添加到按钮的单击事件处理程序中的括号 { 和 } 之间，并确保用您的服务器的主机名称替代 otnsrvr：
string oradb = "data source=(description=(address_list=" + "(address=(protocol=tcp)(host=otnsrvr)(port=1521)))" + "(connect_data=(server=dedicated)(service_name=orcl)));" + "user id=scott;password=tiger;";oracleconnection conn = new oracleconnection(oradb); // c#conn.open();oraclecommand cmd = new oraclecommand();cmd.connection = conn;cmd.commandtext = "select dname from dept where deptno = 10";cmd.commandtype = commandtype.text;oracledatareader dr = cmd.executereader();dr.read();label1.text = dr.getstring(0);conn.dispose();
运行应用程序。 单击按钮。 您将看到以下内容：
上机操作 2： 增加交互性
现在在代码中实施了数据库访问的基础，下一步是为应用程序增加交互性。 可以添加一个文本框来接收用户输入的部门号码 (deptno)，而不是运行硬编码的查询。
向表单中添加一个文本框控件和另一个标签控件： 将 label2 控件的文本属性设为 enter deptno: 并确保没有将 textbox1 的 text 属性设为任何东西。
修改定义选择字符串的代码：
cmd.commandtext = "select dname from dept where deptno = " + textbox1.text 'vb.netcmd.commandtext = "select dname from dept where deptno = " + textbox1.text; // c#
运行应用程序。 在 deptno 输入 10，测试应用程序。 输入一个无效的 deptno，重新测试应用程序。 应用程序将退出。
修改代码以防止在输入无效的 deptno 时出现错误。 让我们回顾一下，executereader 方法实际返回一个对象。
if dr.read() then ' vb.net label1.text = dr.item("dname")else label1.text = "deptno not found"end ifif (dr.read()) // c#{ label1.text = dr.item("dname");}else{ label1.text = "deptno not found";}
输入不存在的 deptno 数字，测试应用程序。 现在应用程序不再退出。 输入字母 a 代替数字，然后单击按钮。 应用程序退出。 很明显，我们的应用程序需要更好的方法以处理错误。
可能有人会指出，应用程序应当不充许用户进行将导致错误的无效输入，但最终应用程序必须添加强健的错误处理功能。 不是所有的错误都是可预防的，因此必须实施错误处理。
上机操作 3： 利用 datareader 检索多行和多列
现在检索了单个值，下一步就是利用 datareader 检索多行和多列。 添加一个 listbox 控件到表单中，以显示结果。
添加一个 listbox 控件到表单中。 重新调整控件的大小，以填满表单的大部分宽度
从查询中删除 where 子句，并添加以下列：
cmd.commandtext = "select deptno, dname, loc from dept" ' vb.netcmd.commandtext = "select deptno, dname, loc from dept"; // c#
修改 vb.net 代码，最终结果如下：
dim oradb as string = "data source=(description=(address_list=" _ + "(address=(protocol=tcp)(host=otnsrvr)(port=1521)))" _ + "(connect_data=(server=dedicated)(service_name=orcl)));" _ + "user id=scott;password=tiger;"dim conn as new oracleconnection(oradb) ' vb.netconn.open()dim cmd as new oraclecommandcmd.connection = conncmd.commandtext = "select deptno, dname, loc from dept" cmd.commandtype = commandtype.textdim dr as oracledatareader = cmd.executereader()while dr.read() listbox1.items.add("the " + dr.item(1) + _" department is in " + dr.item("loc"))end whileconn.dispose()
修改您的 c# 代码，最终结果如下：
string oradb = "data source=(description=(address_list=" + "(address=(protocol=tcp)(host=otnsrvr)(port=1521)))" + "(connect_data=(server=dedicated)(service_name=orcl)));" + "user id=scott;password=tiger;";oracleconnection conn = new oracleconnection(oradb); // c#conn.open();oraclecommand cmd = new oraclecommand();cmd.connection = conn;cmd.commandtext = "select dname from dept where deptno = 10";cmd.commandtype = commandtype.text;oracledatareader dr = cmd.executereader();while (dr.read()){ listbox1.items.add("the " + dr.item(1) + " department is in " + dr.getstring(0));}conn.dispose();
提供代码下载中已经实施了错误处理。
