在.NET中調用Oracle9i存儲過程經驗總結

在.NET中調用Oracle9i存儲過程可以用多個數據提供者，比如OralceClient，OleDb。本文將用OralceClient爲例。.NET語言用C#。

一、調用一個帶輸入、輸出參數的存儲過程

首先，在Oralce中創建存儲過程如下：

create or replace procedure GetRecords(name_out out varchar2,age_in in varchar2) as

begin

select NAME into name_out from test where AGE = age_in;

end;

然後，在C#項目中作如下調用：

string connectionString = "Data Source=YXZHANG;User ID=YXZHANG;Password=YXZHANG";

string queryString = "getrecords";

OracleConnection cn = new OracleConnection(connectionString);

OracleCommand cmd = new OracleCommand(queryString,cn);

cmd.CommandType = CommandType.StoredProcedure;

cmd.Parameters.Add("name_out",OracleType.VarChar,20);

cmd.Parameters["name_out"].Direction = ParameterDirection.Output;

cmd.Parameters.Add("age_in",21);

try

{

cn.Open();

cmd.ExecuteNonQuery();

Console.WriteLine("Name is:{0}",cmd.Parameters["name_out"].Value.ToString());

cn.Close();

}

catch( OracleException ex )

{

Console.WriteLine("Exception occurred!");

Console.WriteLine("The exception message is:{0}",ex.Message.ToString());

}

finally

{

Console.WriteLine("------------------End-------------------");

}

小結：

以上是很平常的調用方法，但是我在做這個示例程序的時候，卻不是那麼一帆風順。這裏要指出OracleClient的一個不盡如人意之處，就是對於參數名稱，必須和存儲過程定義中的參數同名，否則就會報錯。比如將代碼中的“name_out”改爲別的名稱的話，就會報異常。但我試着用OleDb代替OralceClient，卻沒有這個問題。不知道在新版本的數據提供程序中會否改進這一點？

二、調用不返回數據的存儲過程

首先，在Oralce中創建存儲過程如下：

create or replace procedure insertRecord(UserID in varchar2,

UserName in varchar2,
                                         UserAge in varchar2) is
    begin
      insert into test values (UserID, UserName, UserAge);
    end;

然後，在C#項目中作如下調用：

string connectionString = "Data Source=YXZHANG;User ID=YXZHANG;Password=YXZHANG";

string queryString = "insertRecord";

OracleConnection cn = new OracleConnection(connectionString);

OracleCommand cmd = new OracleCommand(queryString,cn);

cmd.CommandType = CommandType.StoredProcedure;

cmd.Parameters.Add("UserID","007");

cmd.Parameters.Add("UserName","Dell");

cmd.Parameters.Add("UserAge","40");

try

{

cn.Open();

cmd.ExecuteNonQuery();

Console.WriteLine("Record inserted!");

cn.Close();

}

catch( OracleException ex )

{

Console.WriteLine("Exception occurred!");

Console.WriteLine("The exception message is:{0}",ex.Message.ToString());

}

finally

{

Console.WriteLine("------------------End-------------------");

}

小結：

不返回數據的存儲過程一般有Delete, Insert, Update等。雖然它們的SQL語句不同，但是調用方面都是一樣的。只要傳入正確的參數，一般不會出什麼問題。不過還是要注意，在使用OralceClient作爲數據提供者的時候，參數名稱一定要和存儲過程定義中的一致！至於參數添加的順序倒是無所謂的，因爲有參數名稱作爲區別。

三、IDENTITY 和 SEQUENCE

Sql Server中，定義一個列爲遞增列很容易，但我在Oracle中卻怎麼也找不到設置的方法。不過查了點資料後知道Oracle中有個叫Sequence的對象，產生一個唯一的序列號，類似於Sql Server中的IDENTITY。於是，我做了如下實驗：

首先，在Oracle中創建了一個名爲TEST_SEQ的Sequence對象，SQL語句如下：

create sequence TEST_SEQ

minvalue 100

maxvalue 999

start with 102

increment by 1

nocache;

語法應該是比較易懂的，最小最大值分別用minvalue,maxvalue表示，初始值是102（這個數字是動態變化的，我創建的時候設的是100，後因插入了2條數據後就自動增加了2），increment當然就是步長了。在PL/SQL中可以用test_seq.nextval訪問下一個序列號，用test_seq.currval訪問當前的序列號。

定義完了Sequence，接下來就是創建一個存儲過程InsertRecordWithSequence：

--這次我修改了test表的定義，和前面的示例不同。其中，UserID是PK。

create or replace procedure InsertRecordWithSequence(UserID out number,

UserName in varchar2,

UserAge in number)

begin

insert into test(id, name, age) --插入一條記錄，PK值從Sequece獲取

values(test_seq.nextval, UserName, UserAge);

/*返回PK值。注意Dual表的用法*/

select test_seq.currval into UserID from dual;

end InsertRecordWithSequence;

接下來，就是在C#中進行調用了：

string connectionString = "Data Source=YXZHANG;User ID=YXZHANG;Password=YXZHANG";

string queryString = "InsertRecordWithSequence";

OracleConnection cn = new OracleConnection(connectionString);

OracleCommand cmd = new OracleCommand(queryString,cn);

cmd.CommandType = CommandType.StoredProcedure;

cmd.Parameters.Add("UserID",OracleType.Number);

cmd.Parameters["UserID"].Direction = ParameterDirection.Output;

cmd.Parameters.Add("UserName","Jack");

cmd.Parameters.Add("UserAge",40);

try

{

cn.Open();

int rowAffected = cmd.ExecuteNonQuery();

Console.WriteLine("{0}行已插入。",rowAffected);

Console.WriteLine("插入行的ID爲：{0}",cmd.Parameters["UserID"].Value.ToString());

cn.Close();

}

catch( OracleException ex )

{

Console.WriteLine("Exception occurred!");

Console.WriteLine("The exception message is:{0}",ex.Message.ToString());

}

finally

{

Console.WriteLine("------------------End-------------------");

}

小結：

使用Sequece對象可以很容易地創建唯一序列，在存儲過程中的調用也十分方便，只要sequence_name.nextval以及sequence.currval就能得到下一個以及當前的序列值。倒是Dual表值得注意。

四、使用DataReader讀取返回的結果集

爲了讓存儲過程返回結果集，必須定義一個遊標變量作爲輸出參數。這和Sql Server中有着很大的不同！並且還要用到Oracle中“包”（Package）的概念，似乎有點繁瑣，但熟悉後也會覺得很方便。

關於“包”的概念，有很多內容可以參考，在此就不贅述了。首先，我創建了一個名爲TestPackage的包，包頭是這麼定義的：

create or replace package TestPackage is

type mycursor is ref cursor; -- 定義遊標變量

procedure GetRecords(ret_cursor out mycursor); -- 定義過程，用遊標變量作爲返回參數

end TestPackage;

包體是這麼定義的：

create or replace package body TestPackage is

/*過程體*/

procedure GetRecords(ret_cursor out mycursor) as

begin

open ret_cursor for select * from test;

end GetRecords;

end TestPackage;

已經萬事具備了，讓我們前臺調用試試：

string connectionString = "Data Source=YXZHANG;User ID=YXZHANG;Password=YXZHANG";

string queryString = "TestPackage.GetRecords"; //注意調用方法

OracleConnection cn = new OracleConnection(connectionString);

OracleCommand cmd = new OracleCommand(queryString,cn);

cmd.CommandType = CommandType.StoredProcedure;

cmd.Parameters.Add("ret_cursor",OracleType.Cursor); //注意這裏的類型

cmd.Parameters["ret_cursor"].Direction = ParameterDirection.Output;

try

{

cn.Open();

OracleDataReader dr = cmd.ExecuteReader();

int i = 1;

while( dr.Read() )

{

Console.WriteLine("Record {0}:",i++);

Console.WriteLine("ID:{0} Name:{1} Age:{2}",

dr.GetOracleNumber(0),

dr.GetOracleString(1),

dr.GetOracleNumber(2));

Console.WriteLine();

}

dr.Close(); //用完DataReader對象要記得及時關閉

cn.Close(); //DataReader對象未關閉之前，不能關閉連接

}

catch( OracleException ex )

{

Console.WriteLine("Exception occurred!");

Console.WriteLine("The exception message is:{0}",ex.Message.ToString());

}

finally

{

Console.WriteLine("------------------End-------------------");

}

請看結果：

Record 1:

ID:100 Name:Tony Age:23

Record 2:

ID:101 Name:Jack Age:40

------------------End-------------------

小結：

包是Oracle特有的概念，Sql Server中找不到相匹配的東西。在我看來，包有點像VC++的類，包頭就是.h文件，包體就是.cpp文件。包頭只負責定義，包體則負責具體實現。如果包返回多個遊標，則DataReader會按照您向參數集合中添加它們的順序來訪問這些遊標，而不是按照它們在過程中出現的順序來訪問。可使用DataReader的NextResult()方法前進到下一個遊標。

五、用返回的結果集填充DataSet

ADO.NET捨棄了原來ADO中RecordSet的概念，而使用全新的DataSet來替代。DataSet可以提供更加強大的功能！有了前面的基礎，利用ADO.NET從Oralce返回DataSet也是非常簡單的。主要思想就是用DataAdapter接收返回的遊標，再用DataAdapter的Fill()方法填充數據集。在下面的例子中，我仍用了前一個例子中建好的TestPackage包。

下面是前臺調用主要代碼：

string connectionString = "Data Source=YXZHANG;User ID=YXZHANG;Password=YXZHANG";

string queryString = "TestPackage.GetRecords";

OracleConnection cn = new OracleConnection(connectionString);

OracleCommand cmd = new OracleCommand(queryString,cn);

cmd.CommandType = CommandType.StoredProcedure;

cmd.Parameters.Add("ret_cursor",OracleType.Cursor);

cmd.Parameters["ret_cursor"].Direction = ParameterDirection.Output;

try

{

cn.Open();

OracleDataAdapter da = new OracleDataAdapter(cmd);

DataSet ds = new DataSet();

da.Fill(ds,"TestTable");

cn.Close();

for( int i = 0;i <= ds.Tables["TestTable"].Rows.Count-1;i++ )

{

string id = ds.Tables["TestTable"].Rows[i]["ID"].ToString();

string name = ds.Tables["TestTable"].Rows[i]["NAME"].ToString();

string age = ds.Tables["TestTable"].Rows[i]["AGE"].ToString();

Console.WriteLine("Record {0}:",i+1);

Console.WriteLine("ID:{0}/tName:{1}/tAge:{2}/n",id,name,age);

}

catch( OracleException ex )

{

Console.WriteLine("Exception occurred!");

Console.WriteLine("The exception message is:{0}",ex.Message.ToString());

}

finally

{

Console.WriteLine("------------------End-------------------");

}

小結：

程序調用後的結果和剛纔用DataReader調用的結果一樣。這裏只說明怎樣利用ADO.NET調用Oracle存儲過程，以及怎樣填充至數據集中。至於怎樣操縱DataSet，不是本文的討論範圍。有興趣的讀者可以參考MSDN以及相關書籍。

六、用DataAdapter更新數據庫

通常用DataAdapter取回DataSet，將會對DataSet進行一些修改，繼而更新數據庫（如果只是爲了獲取數據，微軟推薦使用DataReader代替DataSet）。然而，通過存儲過程更新數據庫，並不是那麼簡單，不能簡單地通過DataAdapter的Update()方法進行更新。必須手動爲DataAdapter添加InsertCommand, DeleteCommand, UpdateCommand，因爲存儲過程對這些操作的細節是不知情的，必須人爲給出。

爲了達成這個目標，我完善了之前的TestPackage包，包頭如下：

create or replace package TestPackage is

type mycursor is ref cursor;

procedure UpdateRecords(id_in in number,newName in varchar2,newAge in number);

procedure SelectRecords(ret_cursor out mycursor);

procedure DeleteRecords(id_in in number);

procedure InsertRecords(name_in in varchar2, age_in in number);

end TestPackage;

包體如下：

create or replace package body TestPackage is
  procedure UpdateRecords(id_in in number, newName in varchar2, newAge in number) as
  begin
    update test set age = newAge, name = newName where id = id_in;
  end UpdateRecords;

  procedure SelectRecords(ret_cursor out mycursor) as
  begin
       open ret_cursor for select * from test;
  end SelectRecords;

  procedure DeleteRecords(id_in in number) as
  begin
       delete from test where id = id_in;
  end DeleteRecords;

  procedure InsertRecords(name_in in varchar2, age_in in number) as
  begin
       insert into test values (test_seq.nextval, name_in, age_in);

--test_seq是一個已建的Sequence對象，請參照前面的示例

end InsertRecords;
end TestPackage;

前臺調用代碼如下，有點繁瑣，請耐心閱讀：

string connectionString = "Data Source=YXZHANG;User ID=YXZHANG;Password=YXZHANG";

string queryString = "TestPackage.SelectRecords";

OracleConnection cn = new OracleConnection(connectionString);

OracleCommand cmd = new OracleCommand(queryString,cn);

cmd.CommandType = CommandType.StoredProcedure;

cmd.Parameters.Add("ret_cursor",OracleType.Cursor);

cmd.Parameters["ret_cursor"].Direction = ParameterDirection.Output;

try

{

cn.Open();

OracleDataAdapter da = new OracleDataAdapter(cmd);

DataSet ds = new DataSet();

da.Fill(ds,"TestTable");

cn.Close();

int count = ds.Tables["TestTable"].Rows.Count;

/*打印原始記錄*/

Console.WriteLine("Old Records is:");

for( int i = 0;i <= count - 1;i++ )

{

string id = ds.Tables["TestTable"].Rows[i]["ID"].ToString();

string name = ds.Tables["TestTable"].Rows[i]["NAME"].ToString();

string age = ds.Tables["TestTable"].Rows[i]["AGE"].ToString();

Console.WriteLine("Record {0}:",i+1);

Console.WriteLine("ID:{0}/tName:{1}/tAge:{2}/n",id,name,age);

}

da.SelectCommand = cmd; //爲DataAdapter指定SelectCommand

OracleCommand updateCmd = new OracleCommand("TestPackage.UpdateRecords",cn);

updateCmd.CommandType = CommandType.StoredProcedure;

updateCmd.Parameters.Add("id_in",OracleType.Number,3,"ID");

updateCmd.Parameters.Add("newName",OracleType.VarChar,20,"NAME");

updateCmd.Parameters.Add("newAge",OracleType.Number,3,"AGE");

da.UpdateCommand = updateCmd; //爲DataAdapter指定UpdateCommand

OracleCommand deleteCmd = new OracleCommand("TestPackage.DeleteRecords",cn);

deleteCmd.CommandType = CommandType.StoredProcedure;

deleteCmd.Parameters.Add("id_in",OracleType.Number,3,"ID");

da.DeleteCommand = deleteCmd; //爲DataAdapter指定DeleteCommand

OracleCommand insertCmd = new OracleCommand("TestPackage.InsertRecords",cn);

insertCmd.CommandType = CommandType.StoredProcedure;

insertCmd.Parameters.Add("name_in",OracleType.VarChar,20,"NAME");

insertCmd.Parameters.Add("age_in",OracleType.Number,3,"AGE");

da.InsertCommand = insertCmd; //爲DataAdapter指定InsertCommand

DataTable newTable = ds.Tables["TestTable"];

/*修改第一條記錄*/

newTable.Rows[0]["AGE"] = 22;

newTable.Rows[0]["NAME"] = "John";

/*刪除一條記錄*/

newTable.Rows[2].Delete();

/*插入一條記錄*/

DataRow newRow = newTable.NewRow();

newRow["NAME"] = "Bob";

newRow["AGE"] = 99;

newTable.Rows.Add(newRow);

cn.Open();

da.Update(newTable); //將更改更新到數據庫

newTable.Clear(); //清空DataTable

da.Fill(newTable); //獲取更改後的數據

cn.Close();

/*打印新記錄*/

Console.WriteLine("New Records is:");

for( int i = 0;i <= newTable.Rows.Count - 1;i++ )

{

string id = newTable.Rows[i]["ID"].ToString();

string name = newTable.Rows[i]["NAME"].ToString();

string age = newTable.Rows[i]["AGE"].ToString();

Console.WriteLine("Record {0}:",i+1);

Console.WriteLine("ID:{0}/tName:{1}/tAge:{2}/n",id,name,age);

}

catch( OracleException ex )

{

Console.WriteLine("Exception occurred!");

Console.WriteLine("The exception message is:{0}",ex.Message.ToString());

}

finally

{

Console.WriteLine("------------------End-------------------");

}

運行結果如下：

Old Records is:

Record 1:

ID:100 Name:Tony Age:23

Record 2:

ID:101 Name:Jack Age:34

Record 3:

ID:103 Name:newAdd Age:100

New Records is:

Record 1:

ID:100 Name:John Age:22

Record 2:

ID:101 Name:Jack Age:34

Record 3:

ID:104 Name:Bob Age:99

------------------End-------------------

小結：

使用Update()方法更新數據庫是非常有用的，但是隻侷限於單個表，對於表連接的情況，還是直接用OracleCommand的ExcuteNonQuery()方法去執行更新操作比較方便。

七、本文總結：

在.NET中利用ADO.NET調用Oralce9i中的存儲過程，函數，包等，可以提高效率，也能完成一些複雜的業務邏輯。然而調用Oracle存儲過程和Sql Server中有着很大不同，最需要明確的一個思想就是：在Oracle的過程中，所有返回值必須以輸出參數的形式出現。在Oracle中，要返回一個結果集，就必須把REF CURSOR作爲返回參數，因此就要用到包。包類似於C++中的類，封裝了一些全局變量、常量和函數，在函數中又可以有自己的私有變量。通過返回給應用程序的遊標，應用程序就可以用DataReader或者DataAdapter接收它，進而做一些處理。還還可以用DataAdapter的Update()方法更新數據庫，當然它需要你給出更新數據庫的一些操作（爲其定義處理過程）。

由於筆者是邊學邊寫，以上示例不免有些不妥之處，請多多指教！

作於農歷二〇〇四年八月二十九夜張玉祥

在.NET中調用Oracle9i存儲過程經驗總結

在.NET中調用Oracle9i存儲過程經驗總結

在.NET中調用Oracle9i存儲過程經驗總結

由DataGrid翻頁所導致的諸多問題的解決方案

Palm初學感想

鳥兒走了，心痛……

總結:Connection大全

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結