使用 ADO.NET 訪問 Oracle 9i 存儲過程

發佈日期： 5/28/2004 | 更新日期： 5/28/2004

Bill Hamilton

2004 年 4 月

適用於：
Microsoft ADO.NET
Microsoft SQL Server
Microsoft .NET Oracle 提供程序
Microsoft .NET Framework 1.1 版

摘要：使用 Microsoft .NET 框架 1.1 中的 Microsoft .NET Oracle 提供程序訪問 Oracle 存儲過程和函數。（24 頁打印頁）

內容

本頁內容

	概述
	類
	執行存儲過程
	不返回數據的存儲過程
	結果集與 REF CURSOR
	包
	使用 DataReader
	返回單個值的存儲過程
	序列
	使用 DataAdapter 填充數據集
	使用 DataAdapter 更新 Oracle
	使用多個結果集
	小結
	相關書籍

本文討論瞭如何使用 ADO.NET 訪問 Oracle 存儲過程（稱爲 SQL 編程塊）和函數（返回單個值的編程塊）。

您可以使用以下託管數據提供程序連接到 Oracle 數據庫：Microsoft .NET Oracle 提供程序、OLE DB .NET 提供程序、ODBC .NET 數據提供程序以及 Oracle 的 ODP.NET 提供程序。本文使用用於 Oracle 的 Microsoft?.NET 框架數據提供程序。使用 Oracle ODP.NET 數據提供程序或用於 OLE DB 的 Microsoft .NET 框架數據提供程序時可使用不同的功能。

Oracle .NET 數據提供程序隨 .NET 框架 1.1 一起提供。如果您使用的是 .NET 框架 1.0，您將需要下載 .NET Managed Provider for Oracle。無論是哪個版本，數據提供程序類都位於 System.Data.OracleClient 命名空間中。

概述

PL/SQL 是 SQL 的 Oracle 實現。它與 Microsoft?SQL Server? 所使用的 T-SQL 類似，但也有一些不同之處，本文稍後對此進行了詳細討論。與 T-SQL 一樣，PL/SQL 擴展了標準 SQL。PL/SQL 用於定義命名編程塊，如存儲過程、函數和觸發器。

返回頁首

類

可使用 System.Data.OracleClient 命名空間中類的子集來執行 Oracle 存儲過程和函數。下表對這些類進行了說明：

類	說明
OracleCommand	針對 Oracle 數據庫執行的存儲過程的 SQL 語句。
OracleConnection	打開的數據庫連接。
OracleParameter	OracleCommand 的參數，也可能是它到 DataColumn 的映射。
OracleParameterCollection	OracleParameter 對象的集合。
OracleType	Oracle 數據類型和結構的枚舉。

返回頁首

執行存儲過程

執行 Oracle 存儲過程與執行 SQL Server 存儲過程類似。下面的步驟說明了如何執行 Oracle 存儲過程和檢索它返回的結果。

在 HR 架構中創建一個名爲 COUNT_JOB_HISTORY 的存儲過程，以計算 JOB_HISTORY 表中的記錄數。

CREATE OR new PROCEDURE COUNT_JOB_HISTORY
(
    reccount OUT NUMBER
)
IS
BEGIN
    SELECT COUNT(*) INTO reccount
    FROM JOB_HISTORY;
END COUNT_JOB_HISTORY;

HR 架構是默認 Oracle 安裝中包含的一個示例。

將 System.Data.OracleClient.dll（用於 Oracle 的 Microsoft .NET 框架數據提供程序）的引用添加到項目中。

使用 using 指令導入 OracleClient 類中的類型。

using System.Data.OracleClient;

創建一個 OracleConnection 對象。

OracleConnection conn = new OracleConnection("Data Source=oracledb;
    User Id=UserID;Password=Password;");

用您的值替換 Oracle 數據庫的名稱、用戶名和密碼。

創建一個 OracleCommand 對象。將其 Connection 屬性設置爲第 4 步中創建的連接。將其 CommandText 設置爲存儲過程的名稱，並將其 CommandText 屬性設置爲 CommandType.StoredProcedure。當您調用第 8 步中介紹的一個 Execute() 方法時，該命令對象將執行指定的存儲過程。

OracleCommand cmd = new OracleCommand();
cmd.Connection = conn;
cmd.CommandText = "COUNT_JOB_HISTORY";
cmd.CommandType = CommandType.StoredProcedure;

如果您的存儲過程名稱含有特殊字符，您就必須使用轉義序列。您可以通過重置 CommandText 屬性來重用現有的 OracleCommand 對象。

創建輸入、輸出和返回值的 OracleParameter 對象，並將其添加到 OracleCommand 對象的參數集合中。

cmd.Parameters.Add("reccount", OracleType.Number).Direction =
    ParameterDirection.Output;

該行代碼是以下兩行代碼的簡寫形式：

cmd.Parameters.Add("reccount", OracleType.Number);
cmd.Parameters["reccount"].Direction = ParameterDirection.Output;

如果您要檢索結果集，請創建 DataSet、DataTable 或 DataReader。在本示例中，我們只是獲取第 6 步中創建的輸出參數中的計數。

使用 OracleCommand 對象的一個 Execute 方法打開連接並執行存儲過程，如下所示：

方法	說明
ExecuteReader	通過執行能夠返回結果集的存儲過程生成 OracleDataReader。
ExecuteNonQuery	執行不返回結果集的查詢或過程，返回受影響的行數。
ExecuteOracleNonQuery	執行查詢，返回受影響的行數。該方法還使用 OracleString 參數來返回 UPDATE、INSERT 或 DELETE 查詢所修改的最後一行的行 ID。
ExecuteScalar	執行一個查詢或過程，並且返回查詢或過程的返回值，或者將結果集第一行第一列的值作爲 .NET 框架數據類型返回。
ExecuteOracleScalar	執行一個查詢或過程，並且返回查詢或過程的返回值，或者將結果集第一行第一列的值作爲 OracleType 數據類型返回。

使用完連接後，不要忘記將其關閉。

conn.Open();
cmd.ExecuteNonQuery();
conn.Close();

如果您要使用 DataAdapter 來填充 DataTable 或 DataSet，可以依靠 DataAdapter 來打開和關閉連接。

處理結果。在我們的示例中，可在顯示到控制檯的輸出參數中得到記錄數：

Console.WriteLine(cmd.Parameters["reccount"].Value);

下面是在本示例中開發的用於執行存儲過程和檢索結果的代碼：

OracleConnection conn = new OracleConnection("Data Source=oracledb;
    User Id=UserID;Password=Password;");

OracleCommand cmd = new OracleCommand();
cmd.Connection = conn;
cmd.CommandText = "COUNT_JOB_HISTORY";
cmd.CommandType = CommandType.StoredProcedure;
cmd.Parameters.Add("reccount", OracleType.Number).Direction =
    ParameterDirection.Output;

conn.Open();
cmd.ExecuteNonQuery();
conn.Close();

Console.WriteLine(cmd.Parameters["reccount"].Value);

返回頁首

不返回數據的存儲過程

OracleCommand 類的 ExecuteOracleNonQuery() 方法用於執行不返回任何行的 SQL 語句或存儲過程。該方法返回一個 int 值，表示受 UPDATE、INSERT 和 DELETE 命令影響的行數；如果沒有任何行受到影響，則返回 -1。如果您所執行的 INSERT、DELETE 或 UPDATE 語句恰好影響一行，則該方法具有單個參數 OracleString out rowid，該參數唯一標識 Oracle 數據庫中受影響的行。可以使用該值來優化後續相關查詢。

還可以使用 OracleCommand 類的 ExecuteNonQuery() 方法來執行不返回數據的存儲過程，但您將無法獲得上面介紹的唯一行標識符。

儘管上述命令都不會返回任何數據，但映射到參數的輸出參數和返回值仍然使用數據進行填充。這使您可以使用上述任一命令從存儲過程返回一個或多個標量值。

以下 Oracle 存儲過程刪除了由單個輸入參數指定的員工的所有工作經歷，並且不返回任何數據。

CREATE OR new PROCEDURE DELETE_JOB_HISTORY
(
    p_employee_id NUMBER
)
IS
BEGIN
    DELETE FROM job_history
    WHERE employee_id = p_employee_id;
END DELETE_JOB_HISTORY;

以下代碼運行了該存儲過程。

// create the connection
OracleConnection conn = new OracleConnection("Data Source=oracledb;
    User Id=UserID;Password=Password;");

// create the command for the stored procedure
OracleCommand cmd = new OracleCommand();
cmd.Connection = conn;
cmd.CommandText = "COUNT_JOB_HISTORY";
cmd.CommandType = CommandType.StoredProcedure;

// add the parameter specifying the employee for whom to delete records
cmd.Parameters.Add("p_employee_id", OracleType.Number).Value = 102;

OracleString rowId;
// execute the stored procedure
conn.Open();
int rowsAffected = cmd.ExecuteNonQuery();
conn.Close();

Console.WriteLine("Rows affected: " + rowsAffected);

如果您尚未修改默認的 HR 安裝，則 JOB_HISTORY 表中員工 102 的記錄被刪除，並且向控制檯輸出以下內容：

Rows affected: 1

訪問返回值

RETURN 語句立即將控制從存儲過程返回到調用程序。Oracle 存儲過程中的 RETURN 語句無法像在 T-SQL 中那樣返回值。

Oracle 函數是計算並返回單個值的子程序。它們的結構類似於存儲過程，不同之處在於它們總是具有必須返回值的 RETURN 子句。

下面是一個返回指定員工的電子郵件的函數：

CREATE OR new FUNCTION GET_EMPLOYEE_EMAIL (
    p_employee_id NUMBER
)
RETURN VARCHAR2
IS p_email VARCHAR2(25);
BEGIN
    SELECT EMAIL INTO p_email FROM EMPLOYEES
    WHERE EMPLOYEE_ID = p_employee_id;
    
    RETURN p_email;
END GET_EMPLOYEE_EMAIL;

執行函數的方式與執行存儲過程的方式相同。可使用 ParameterDirection.ReturnValue 參數獲得由函數返回的結果。以下代碼顯示了使用方法：

// create the connection
OracleConnection conn = new OracleConnection("Data Source=oracledb;
    User Id=UserID;Password=Password;");

// create the command for the function
OracleCommand cmd = new OracleCommand();
cmd.Connection = conn;
cmd.CommandText = "GET_EMPLOYEE_EMAIL";
cmd.CommandType = CommandType.StoredProcedure;

// add the parameters, including the return parameter to retrieve
// the return value
cmd.Parameters.Add("p_employee_id", OracleType.Number).Value = 101;
cmd.Parameters.Add("p_email", OracleType.VarChar, 25).Direction =
    ParameterDirection.ReturnValue;

// execute the function
conn.Open();
cmd.ExecuteNonQuery();
conn.Close();

// output the result
Console.WriteLine("Email address is: " + cmd.Parameters["p_email"].Value);

控制檯輸出顯示了員工 101 的電子郵件地址。

Email address is: NKOCHHAR

返回頁首

結果集與 REF CURSOR

可使用 REF CURSOR 數據類型來處理 Oracle 結果集。REF CURSOR 是一個指向 PL/SQL 查詢所返回的結果集的指針。與普通的遊標不同，REF CURSOR 是一個變量，它是對遊標的引用，可以在執行時將其設置爲指向不同的結果集。使用 REF CURSOR 輸出參數可以將 Oracle 結構化程序的結果集傳遞迴調用應用程序。通過在調用應用程序中定義 OracleType.Cursor 數據類型的輸出參數，可以訪問 REF CURSOR 所指向的結果集。在使用 REF CURSOR 的過程中，OracleConnection 必須保持打開狀態。

返回頁首

包

PL/SQL 和 T-SQL 中的存儲過程之間的一個重大差異是 PL/SQL 所使用的 Oracle 包結構。在 T-SQL 中沒有等效元素。包是在邏輯上相關的編程塊（如存儲過程和函數）的容器。它包含兩個部分：

•	規範：定義包的名稱，併爲包中的每個存儲過程或函數提供方法簽名（原型）。規範頭還定義所有全局聲明。規範的樣式類似於 C 或 C++ 頭文件。
•	正文：包含包頭中定義的存儲過程和函數的代碼。

每個存儲過程或函數的參數都出現在括號內，並且用逗號分隔。每個參數還根據需要用以下三個標識符中的一個進行標記：

•	IN：該值從調用應用程序傳遞到 PL/SQL 塊。如果未指定標識符，則 IN 爲默認傳遞方向。
•	OUT：該值由存儲過程生成，並傳遞迴調用應用程序。
•	INOUT：該值被傳遞到 PL/SQL 塊，可能在該塊內部進行修改，然後返回到調用應用程序。

每個參數也都被標記以指示數據類型。

以下包規範定義了四個過程，它們在 HR 架構的 LOCATIONS 表中創建、檢索、更新和刪除數據。

CREATE OR new PACKAGE CRUD_LOCATIONS AS
TYPE T_CURSOR IS REF CURSOR;
PROCEDURE GetLocations (cur_Locations OUT T_CURSOR);
PROCEDURE UpdateLocations (p_location_id IN NUMBER,
    p_street_address IN VARCHAR2,
    p_postal_code IN VARCHAR2,
    p_city IN VARCHAR2,
    p_state_province IN VARCHAR2,
    p_country_id IN CHAR);
PROCEDURE DeleteLocations (p_location_id IN NUMBER);
PROCEDURE InsertLocations (p_location_id OUT NUMBER,
    p_street_address IN VARCHAR2,
    p_postal_code IN VARCHAR2,
    p_city IN VARCHAR2,
    p_state_province IN VARCHAR2,
    p_country_id IN CHAR);
END CRUD_LOCATIONS;

以下代碼摘自上述包規範的包正文，說明了 GetLocations 包中的第一個過程的實現細節：

CREATE OR new PACKAGE BODY CRUD_LOCATIONS AS
PROCEDURE GetLocations (cur_Locations OUT T_CURSOR)
IS
BEGIN
    OPEN cur_Locations FOR
    SELECT * FROM LOCATIONS;
END GetLocations;

-- Implementation of other procedures ommitted.

END CRUD_LOCATIONS;

返回頁首

使用 DataReader

可以通過調用 OracleCommand 對象的 ExecuteReader() 方法來創建 OracleDataReader。本節說明如何使用 DataReader 來訪問由存儲過程 SELECT_JOB_HISTORY 返回的結果集。以下爲包規範：

CREATE OR new PACKAGE SELECT_JOB_HISTORY AS
TYPE T_CURSOR IS REF CURSOR;
PROCEDURE GetJobHistoryByEmployeeId
(
    p_employee_id IN NUMBER,
    cur_JobHistory OUT T_CURSOR
);
END SELECT_JOB_HISTORY;

包正文定義了一個過程，該過程檢索指定員工的工作經歷的結果集，並將其作爲 REF CURSOR 輸出參數返回：

CREATE OR new PACKAGE BODY SELECT_JOB_HISTORY AS
PROCEDURE GetJobHistoryByEmployeeId
(
    p_employee_id IN NUMBER,
    cur_JobHistory OUT T_CURSOR
)
IS
BEGIN
    OPEN cur_JobHistory FOR
    SELECT * FROM JOB_HISTORY
        WHERE employee_id = p_employee_id;

END GetJobHistoryByEmployeeId;
END SELECT_JOB_HISTORY;

以下代碼執行該過程，根據結果集創建 DataReader，並將 DataReader 的內容輸出到控制檯。

// create connection
OracleConnection conn = new OracleConnection("Data Source=oracledb;
    User Id=UserID;Password=Password;");

// create the command for the stored procedure
OracleCommand cmd = new OracleCommand();
cmd.Connection = conn;
cmd.CommandText = "SELECT_JOB_HISTORY.GetJobHistoryByEmployeeId";
cmd.CommandType = CommandType.StoredProcedure;

// add the parameters for the stored procedure including the REF CURSOR
// to retrieve the result set
cmd.Parameters.Add("p_employee_id", OracleType.Number).Value = 101;
cmd.Parameters.Add("cur_JobHistory", OracleType.Cursor).Direction =
    ParameterDirection.Output;

// open the connection and create the DataReader
conn.Open();
OracleDataReader dr = cmd.ExecuteReader();

// output the results and close the connection.
while(dr.Read())
{
    for(int i = 0; i < dr.FieldCount; i++)
        Console.Write(dr[i].ToString() + ";");
    Console.WriteLine();
}
conn.Close();

對於 HR 架構的默認安裝，控制檯輸出顯示了員工 101 的兩個記錄中每個記錄的字段（用分號分隔）：

101;9/21/1989 12:00:00 AM;10/27/1993 12:00:00 AM;AC_ACCOUNT;110;
101;10/28/1993 12:00:00 AM;3/15/1997 12:00:00 AM;AC_MGR;110;

上述代碼顯示，包中的過程是使用包名稱 (ELECT_JOB_HISTORY) 和過程的名稱（在此情況下爲 GetJobHistoryByEmployeeId）指定的，二者之間用句點分隔。

代碼還說明了如何定義結果集的 REF CURSOR 參數。請注意，數據類型爲 OracleType.Cursor，方向爲 ParameterDirection.Output。

還請注意，在訪問 REF CURSOR 中的結果集的整個過程中，連接都保持打開狀態。

如果包返回多個遊標，則 DataReader 會按照您向參數集合中添加它們的順序來訪問這些遊標，而不是按照它們在過程中出現的順序來訪問。可使用 DataReader 的 NextResult() 方法前進到下一個遊標。

返回頁首

返回單個值的存儲過程

OracleCommand 類的 ExecuteOracleScalar() 方法用於執行將單個值作爲 OracleType 數據類型返回的 SQL 語句或存儲過程。如果命令返回一個結果集，則該方法會返回第一行第一列的值。如果返回了 REF CURSOR，而不是返回了 REF CURSOR 所指向的第一行第一列的值，則該方法會返回一個空引用。OracleCommand 類的 ExecuteScalar() 方法類似於 ExecuteOracleScalar() 方法，只不過它將值作爲 .NET 框架數據類型返回。

儘管如此，在使用 Oracle 存儲過程時，這兩個方法都沒有用。Oracle 存儲過程不能將值作爲 RETURN 語句的一部分返回，而只能將其作爲 OUT 參數返回。有關信息，請參閱不返回數據的存儲過程一節。同時，除了通過 REF CURSOR 輸出參數以外，您不能返回結果集。下一節將對此進行討論。

您只能使用 RETURN 參數檢索 Oracle 函數的返回值（如上一節所述），而不能使用 ExecuteScalar 方法之一進行檢索。

返回頁首

序列

Oracle 使用序列來生成唯一編號，而不是使用 SQL Server 所用的數據類型 uniqueidentifier。無論是哪種情況，主要用途都是爲主鍵列生成一系列唯一編號。與 uniqueidentifier 數據類型不同，序列是與將其用於主鍵值的一個或多個表無關的數據庫對象。

Oracle 序列是原子對象，並且是一致的。也就是說，一旦您訪問一個序列號，Oracle 將在處理下一個請求之前自動遞增下一個編號，從而確保不會出現重複值。

可以使用 CREATE SEQUENCE 命令創建 Oracle 序列。該命令所帶參數包括增量、起始值、最大值、循環和緩存。可使用 NEXTVAL 和 CURRVAL 關鍵字訪問序列值。NEXTVAL 返回序列中的下一個編號，而 CURRVAL 提供對當前值的訪問。HR 架構中的序列 LOCATIONS_SEQ 按如下方式定義：

CREATE SEQUENCE LOCATIONS_SEQ
    INCREMENT BY 100
    START WITH 1
    MAXVALUE 9900
    MINVALUE 1
    NOCYCLE 
    NOCACHE
    NOORDER

大多數序列代碼是不言自明的。NOCYCLE 表示序列在達到最小值或最大值後將不再生成其他值。NOCACHE 表示序列值在被請求之前不會進行分配；可使用預分配機制來改善性能。NOORDER 表示在生成編號時，不能保證按照請求編號的順序返回這些編號。

下面的代碼顯示了一個存儲過程，該過程請求一個序列值，在向 LOCATIONS 表中插入記錄時使用它設置主鍵值，然後在 OUT 參數中返回該主鍵值。

CREATE OR new PROCEDURE ADD_LOCATION (
    p_location_id OUT NUMBER,
    p_street_address IN VARCHAR2,
    p_postal_code IN VARCHAR2,
    p_city IN VARCHAR2,
    p_state_province IN VARCHAR2,
    p_country_id IN CHAR
)
AS
BEGIN
    INSERT INTO LOCATIONS (
        LOCATION_ID,
        STREET_ADDRESS,
        POSTAL_CODE,
        CITY,
        STATE_PROVINCE,
        COUNTRY_ID)
    VALUES (
        LOCATIONS_SEQ.NEXTVAL,
        p_street_address,
        p_postal_code,
        p_city,
        p_state_province,
        p_country_id
    );
    
    SELECT LOCATIONS_SEQ.CURRVAL INTO p_location_id FROM DUAL;
END ADD_LOCATION;

下面的代碼調用該存儲過程，以插入一個記錄並檢索返回的序列值。

// create the connection
OracleConnection conn = new OracleConnection("Data Source=oracledb;
    User Id=UserID;Password=Password;");

// create the command for the stored procedure
OracleCommand cmd = new OracleCommand();
cmd.Connection = conn;
cmd.CommandText = "ADD_LOCATION";
cmd.CommandType = CommandType.StoredProcedure;

// add the parameters for the stored procedure including the LOCATION_ID
// sequence value that is returned in the output parameter p_location_id
cmd.Parameters.Add("p_location_id", OracleType.Number).Direction =
    ParameterDirection.Output;
cmd.Parameters.Add("p_street_address", OracleType.VarChar).Value =
    "123 Any Street";
cmd.Parameters.Add("p_postal_code", OracleType.VarChar).Value = "33040";
cmd.Parameters.Add("p_city", OracleType.VarChar).Value = "Key West";
cmd.Parameters.Add("p_state_province", OracleType.VarChar).Value = "FL";
cmd.Parameters.Add("p_country_id", OracleType.VarChar).Value = "US";

// execute the command to add the records      
OracleString rowId;
conn.Open();
int rowsAffected = cmd.ExecuteOracleNonQuery(out rowId);
conn.Close();

// output the results
Console.WriteLine("Rows affected: " + rowsAffected);
Console.WriteLine("Location ID: " +
    cmd.Parameters["p_location_id"].Value);

控制檯顯示一個記錄被插入到該表中，同時還插入了該序列生成的主鍵值。

Rows affected: 1
Location ID: 3300

返回頁首

使用 DataAdapter 填充數據集

可使用 REF CURSOR 通過 DataAdapter 來填充 DataSet。下面的代碼利用了使用 DataReader 一節中定義的存儲過程 GetJobHistoryByEmployeeId，並用它在 REF CURSOR 輸出參數中返回的結果集來填充 DataSet。

以下是使用 DataAdapter 填充 DataSet 的代碼：

// create the connection
OracleConnection conn = new OracleConnection("Data Source=oracledb;
    User Id=UserID;Password=Password;");

// create the command for the stored procedure
OracleCommand cmd = new OracleCommand();
cmd.Connection = conn;
cmd.CommandText = "SELECT_JOB_HISTORY.GetJobHistoryByEmployeeId";
cmd.CommandType = CommandType.StoredProcedure;

// add the parameters for the stored procedure including the REF CURSOR
// to retrieve the result set
cmd.Parameters.Add("p_employee_id", OracleType.Number).Value = 101;
cmd.Parameters.Add("cur_JobHistory", OracleType.Cursor).Direction =
    ParameterDirection.Output;

// createt the DataAdapter from the command and use it to fill the
// DataSet
OracleDataAdapter da = new OracleDataAdapter(cmd);
DataSet ds = new DataSet();
da.Fill(ds);

// output the results.
Console.WriteLine(ds.Tables[0].Rows.Count);

對於 HR 架構的默認安裝，輸出表明員工 101 有兩個 JOB_HISTORY 記錄。

返回頁首

使用 DataAdapter 更新 Oracle

當您使用 REF CURSOR 參數填充 DataSet 時，不能簡單地使用 OracleDataAdapter 的 Update() 方法。這是因爲在執行存儲過程時，Oracle 不能提供確定表名和列名所需的信息。要使用 DataAdapter 的 Update() 方法，您必須創建在基礎表中更新、插入和刪除記錄的過程。該方法類似於在 SQL Server 中使用的方法。

本節說明如何生成一個可以處理所需的創建、檢索、更新和刪除操作的包，以便能夠從 Oracle 數據庫中檢索 LOCATION 數據，也能夠將對 DataSet 數據所做的不連續更改重新更新到 Oracle 數據庫。包頭如下所示：

CREATE OR new PACKAGE CRUD_LOCATIONS AS
TYPE T_CURSOR IS REF CURSOR;
PROCEDURE GetLocations (cur_Locations OUT T_CURSOR);
PROCEDURE UpdateLocations (
    p_location_id IN NUMBER,
    p_street_address IN VARCHAR2,
    p_postal_code IN VARCHAR2,
    p_city IN VARCHAR2,
    p_state_province IN VARCHAR2,
    p_country_id IN CHAR);
PROCEDURE DeleteLocations (p_location_id IN NUMBER);
PROCEDURE InsertLocations (
    p_location_id OUT NUMBER,
    p_street_address IN VARCHAR2,
    p_postal_code IN VARCHAR2,
    p_city IN VARCHAR2,
    p_state_province IN VARCHAR2,
    p_country_id IN CHAR);
END CRUD_LOCATIONS;

包正文如下所示：

CREATE OR new PACKAGE BODY CRUD_LOCATIONS AS
-- retrieve all LOCATION records
PROCEDURE GetLocations (cur_Locations OUT T_CURSOR)
IS
BEGIN
    OPEN cur_Locations FOR
    SELECT * FROM LOCATIONS;
END GetLocations;

-- update a LOCATION record
PROCEDURE UpdateLocations (
    p_location_id IN NUMBER,
    p_street_address IN VARCHAR2,
    p_postal_code IN VARCHAR2,
    p_city IN VARCHAR2,
    p_state_province IN VARCHAR2,
    p_country_id IN CHAR)
IS
BEGIN
    UPDATE LOCATIONS
    SET
        STREET_ADDRESS = p_street_address,
        POSTAL_CODE = p_postal_code,
        CITY = p_city,
        STATE_PROVINCE = p_state_province,
        COUNTRY_ID = p_country_id
    WHERE
        LOCATION_ID = p_location_id;        
END UpdateLocations;

-- delete a LOCATION record
PROCEDURE DeleteLocations (p_location_id IN NUMBER)
IS
BEGIN
     DELETE FROM LOCATIONS
     WHERE LOCATION_ID = p_location_id;
END DeleteLocations;

-- insert a LOCATION record
PROCEDURE InsertLocations
(
    p_location_id OUT NUMBER,
    p_street_address IN VARCHAR2,
    p_postal_code IN VARCHAR2,
    p_city IN VARCHAR2,
    p_state_province IN VARCHAR2,
    p_country_id IN CHAR
)
AS
BEGIN
    INSERT INTO LOCATIONS (
        LOCATION_ID,
        STREET_ADDRESS,
        POSTAL_CODE,
        CITY,
        STATE_PROVINCE,
        COUNTRY_ID)
    VALUES (
        LOCATIONS_SEQ.NEXTVAL,
        p_street_address,
        p_postal_code,
        p_city,
        p_state_province,
        p_country_id
    );
    
    SELECT LOCATIONS_SEQ.CURRVAL INTO p_location_id FROM DUAL;
END InsertLocations;
END CRUD_LOCATIONS;

下面的代碼定義了一個 DataAdapter，從而使用上述包中定義的過程來創建、檢索、更新和刪除支持 DataAdapter 的數據。DataAdapter 既可用來將數據檢索到 DataSet 中，也可用來將對 DataSet 所做的更改更新到 Oracle 數據庫中。

// define the connection string
String connString = "Data Source=oracledb;User Id=UserID;Password=Password;";

// create the data adapter
OracleDataAdapter da = new OracleDataAdapter();

// define the select command for the data adapter
OracleCommand selectCommand =
    new OracleCommand("CRUD_LOCATIONS.GetLocations",
    new OracleConnection(connString));
selectCommand.CommandType = CommandType.StoredProcedure;
selectCommand.Parameters.Add("cur_Locations",
    OracleType.Cursor).Direction = ParameterDirection.Output;
da.SelectCommand = selectCommand;

// define the udpate command for the data adapter
OracleCommand updateCommand =
    new OracleCommand("CRUD_LOCATIONS.UpdateLocations",
    new OracleConnection(connString));
updateCommand.CommandType = CommandType.StoredProcedure;
updateCommand.Parameters.Add("p_location_id", OracleType.Number, 4,
    "LOCATION_ID");
updateCommand.Parameters.Add("p_street_address", OracleType.VarChar, 40,
    "STREET_ADDRESS");
updateCommand.Parameters.Add("p_postal_code", OracleType.VarChar, 12,
    "POSTAL_CODE");
updateCommand.Parameters.Add("p_city", OracleType.VarChar, 30, "CITY");
updateCommand.Parameters.Add("p_state_province", OracleType.VarChar, 25,
    "STATE_PROVINCE");
updateCommand.Parameters.Add("p_country_id", OracleType.Char, 2,
    "COUNTRY_ID");
da.UpdateCommand = updateCommand;

// define the delete command for the data adapter
OracleCommand deleteCommand =
    new OracleCommand("CRUD_LOCATIONS.DeleteLocations",
    new OracleConnection(connString));
deleteCommand.CommandType = CommandType.StoredProcedure;
deleteCommand.Parameters.Add("p_location_id", OracleType.Number, 4,
    "LOCATION_ID");
da.DeleteCommand = deleteCommand;

OracleCommand insertCommand =
    new OracleCommand("CRUD_LOCATIONS.InsertLocations",
    new OracleConnection(connString));
insertCommand.CommandType = CommandType.StoredProcedure;
insertCommand.Parameters.Add("p_location_id", OracleType.Number, 4,
    "LOCATION_ID");
insertCommand.Parameters.Add("p_street_address", OracleType.VarChar, 40,
    "STREET_ADDRESS");
insertCommand.Parameters.Add("p_postal_code", OracleType.VarChar, 12,
    "POSTAL_CODE");
insertCommand.Parameters.Add("p_city", OracleType.VarChar, 30, "CITY");
insertCommand.Parameters.Add("p_state_province", OracleType.VarChar, 25,
    "STATE_PROVINCE");
insertCommand.Parameters.Add("p_country_id", OracleType.Char, 2,
    "COUNTRY_ID");
da.InsertCommand = insertCommand;

// define a DataTable and fill it using the data adapter
DataTable dt = new DataTable();
da.Fill(dt);

// ... do work that adds, edits, updates, or deletes records in the table

// call the Update() method of the data adapter to update the Oracle
// database with changes made to the data
da.Update(dt);

返回頁首

使用多個結果集

Oracle 不支持批量查詢，因此無法從一個命令返回多個結果集。使用存儲過程時，返回多個結果集類似於返回單個結果集；必須使用 REF CURSOR 輸出參數。要返回多個結果集，請使用多個 REF CURSOR 輸出參數。

以下是返回兩個結果集（全部 EMPLOYEES 和 JOBS 記錄）的包規範：

CREATE OR new PACKAGE SELECT_EMPLOYEES_JOBS AS
TYPE T_CURSOR IS REF CURSOR;
PROCEDURE GetEmployeesAndJobs (
    cur_Employees OUT T_CURSOR,    
    cur_Jobs OUT T_CURSOR
);
END SELECT_EMPLOYEES_JOBS;

包正文如下所示：

CREATE OR new PACKAGE BODY SELECT_EMPLOYEES_JOBS AS
PROCEDURE GetEmployeesAndJobs
(
    cur_Employees OUT T_CURSOR,
    cur_Jobs OUT T_CURSOR
)
IS
BEGIN
    -- return all EMPLOYEES records
    OPEN cur_Employees FOR
    SELECT * FROM Employees;

    -- return all JOBS records
    OPEN cur_Jobs FOR
    SELECT * FROM Jobs;
END GetEmployeesAndJobs;
END SELECT_EMPLOYEES_JOBS;

以下代碼顯示瞭如何使用從上述包中返回的兩個結果集來填充 DataSet 中的兩個相關表：

// create the connection
OracleConnection conn = new OracleConnection("Data Source=oracledb;
    User Id=UserID;Password=Password;");

// define the command for the stored procedure
OracleCommand cmd = new OracleCommand();
cmd.Connection = conn;
cmd.CommandText = "SELECT_EMPLOYEES_JOBS.GetEmployeesAndJobs";

// add the parameters including the two REF CURSOR types to retrieve
// the two result sets
cmd.Parameters.Add("cur_Employees", OracleType.Cursor).Direction =
    ParameterDirection.Output;
cmd.Parameters.Add("cur_Jobs", OracleType.Cursor).Direction =
    ParameterDirection.Output;
cmd.CommandType = CommandType.StoredProcedure;

// create the DataAdapter and map tables
OracleDataAdapter da = new OracleDataAdapter(cmd);
da.TableMappings.Add("Table", "EMPLOYEES");
da.TableMappings.Add("Table1", "JOBS");

// create and fill the DataSet
DataSet ds = new DataSet();
da.Fill(ds);

// create a relation
ds.Relations.Add("EMPLOYEES_JOBS_RELATION",
   ds.Tables["JOBS"].Columns["JOB_ID"],
   ds.Tables["EMPLOYEES"].Columns["JOB_ID"]);

// output the second employee (zero-based array) and job title
// based on the relation
Console.WriteLine("Employee ID: " +
    ds.Tables["EMPLOYEES"].Rows[1]["EMPLOYEE_ID"] +
    "; Job Title: " +
    ds.Tables["EMPLOYEES"].Rows[1].GetParentRow(
    "EMPLOYEES_JOBS_RELATION")["JOB_TITLE"]);

控制檯輸出顯示了第二個員工的職務：

Employee ID: 101; Job Title: Administration Vice President

返回頁首

小結

通過 Oracle .NET 數據提供程序，可以方便地執行存儲過程以及訪問返回值（無論返回值是一個還是多個標量值或結果集）。可以將 Oracle 過程與 OracleDataAdapter 結合使用，從而填充 DataSet、處理不連續的數據以及以後將更改更新到 Oracle 數據庫。

Oracle 過程與 Microsoft SQL Server 存儲過程之間的主要區別是：Oracle 過程必須將值作爲輸出參數返回，並且必須使用輸出參數將結果集作爲 REF CURSOR 對象返回給調用程序。

返回頁首

使用 ADO.NET 訪問 Oracle 9i 存儲過程

使用 ADO.NET 訪問 Oracle 9i 存儲過程

本頁內容

概述

類

執行存儲過程

不返回數據的存儲過程

結果集與 REF CURSOR

包

使用 DataReader

返回單個值的存儲過程

序列

使用 DataAdapter 填充數據集

使用 DataAdapter 更新 Oracle

使用多個結果集

小結

相關書籍

Wireshark 安裝+使用（一）

ASP.NET2.0實現頁面無刷新CallBack_修正版[轉貼]

Button按鈕的一些常用方法

模板中的數據綁定

用戶控件的一些常用方法和注意事項

使用 ADO.NET 訪問 Oracle 9i 存儲過程

Mac下配置sublime實現LaTeX

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

linux以太網驅動總結