ASP程式與SQL預存程序結合使用詳解

定義總是很抽象。儲存進程其實就是能完成一定操作的一組SQL語句，只不過這組語句是放在資料庫中的(這裡我們只談SQL SERVER)。如果我們通過建立儲存進程以及在ASP中調用儲存進程，就可以避免將SQL語句同ASP代碼混雜在一起。這樣做的好處至少有三個：
第一、大大提高效率。儲存進程本身的執行速度非常快，而且，調用儲存進程可以大大減少同資料庫的互動次數。
第二、提高安全性。假如將SQL語句混合在ASP代碼中，一旦代碼失密，同時也就意味著庫結構失密。
第三、有利於SQL語句的重用。

在ASP中，一般通過COMMAND對象調用儲存進程，根據不同情況，本文也介紹其它調用方法。為了方便說明，根據儲存進程的輸入輸出，作以下簡單分類：
1. 只返回單一記錄集的儲存進程
假設有以下儲存進程(本文的目的不在於講述T-SQL文法，所以儲存進程只給出代碼，不作說明)：

/*SP1*/
CREATE PROCEDURE DBO.GETUSERLIST
AS
SET NOCOUNT ON
BEGIN
SELECT * FROM DBO.[USERINFO]
END
GO

以上儲存進程取得USERINFO表中的所有記錄，返回一個記錄集。通過COMMAND對象調用該儲存進程的ASP代碼如下:

'**通過COMMAND對象調用儲存進程**
DIM MYCOMM,MYRST
SET MYCOMM = SERVER.CREATEOBJECT("ADODB.COMMAND")
MYCOMM.ACTIVECONNECTION = MYCONSTR 'MYCONSTR是資料庫連接字串
MYCOMM.COMMANDTEXT = "GETUSERLIST" '指定儲存進程名
MYCOMM.COMMANDTYPE = 4 '表明這是一個儲存進程
MYCOMM.PREPARED = TRUE '要求將SQL命令先行編譯
SET MYRST = MYCOMM.EXECUTE
SET MYCOMM = NOTHING

儲存進程取得的記錄集賦給MYRST，接下來，可以對MYRST進行操作。
在以上代碼中，COMMANDTYPE屬性工作表明請求的類型，取值及說明如下：
-1 表明COMMANDTEXT參數的類型無法確定
1 表明COMMANDTEXT是一般的命令類型
2 表明COMMANDTEXT參數是一個具有的表名稱
4 表明COMMANDTEXT參數是一個儲存進程的名稱

還可以通過CONNECTION對象或RECORDSET對象調用儲存進程，方法分別如下：

'**通過CONNECTION對象調用儲存進程**
DIM MYCONN,MYRST
SET MYCONN = SERVER.CREATEOBJECT("ADODB.CONNECTION")
MYCONN.OPEN MYCONSTR 'MYCONSTR是資料庫連接字串
SET MYRST = MYCONN.EXECUTE("GETUSERLIST",0,4) '最後一個參斷含義同COMMANDTYPE
SET MYCONN = NOTHING

'**通過RECORDSET對象調用儲存進程**
DIM MYRST
SET MYRST = SERVER.CREATEOBJECT("ADODB.RECORDSET")
MYRST.OPEN "GETUSERLIST",MYCONSTR,0,1,4
'MYCONSTR是資料庫連接字串,最後一個參斷含義與COMMANDTYPE相同

2. 沒有輸入輸出的儲存進程
請看以下儲存進程：

/*SP2*/
CREATE PROCEDURE DBO.DELUSERALL
AS
SET NOCOUNT ON
BEGIN
DELETE FROM DBO.[USERINFO]
END
GO

該儲存進程刪去USERINFO表中的所有記錄，沒有任何輸入及輸出，調用方法與上面講過的基本相同，只是不用取得記錄集：

'**通過COMMAND對象調用儲存進程**
DIM MYCOMM
SET MYCOMM = SERVER.CREATEOBJECT("ADODB.COMMAND")
MYCOMM.ACTIVECONNECTION = MYCONSTR 'MYCONSTR是資料庫連接字串
MYCOMM.COMMANDTEXT = "DELUSERALL" '指定儲存進程名
MYCOMM.COMMANDTYPE = 4 '表明這是一個儲存進程
MYCOMM.PREPARED = TRUE '要求將SQL命令先行編譯
MYCOMM.EXECUTE '此處不必再取得記錄集
SET MYCOMM = NOTHING

當然也可通過CONNECTION對象或RECORDSET對象調用此類儲存進程，不過建立RECORDSET對象是為了取得記錄集，在沒有返回記錄集的情況下，還是利用COMMAND對象吧。

3. 有傳回值的儲存進程
在進行類似SP2的操作時，應充分利用SQL SERVER強大的交易處理功能，以維護資料的一致性。並且，我們可能需要儲存進程返回執行情況，為此，將SP2修改如下：

/*SP3*/
CREATE PROCEDURE DBO.DELUSERALL
AS
SET NOCOUNT ON
BEGIN
BEGIN TRANSACTION
DELETE FROM DBO.[USERINFO]
IF @@ERROR=0
BEGIN
COMMIT TRANSACTION
RETURN 1
END
ELSE
BEGIN
ROLLBACK TRANSACTION
RETURN 0
END
RETURN
END
GO

以上儲存進程，在DELETE順利執行時，返回1，否則返回0，並進行復原操作。為了在ASP中取得傳回值，需要利用PARAMETERS集合來聲明參數：

'**調用帶有傳回值的儲存進程並取得傳回值**
DIM MYCOMM,MYPARA
SET MYCOMM = SERVER.CREATEOBJECT("ADODB.COMMAND")
MYCOMM.ACTIVECONNECTION = MYCONSTR 'MYCONSTR是資料庫連接字串
MYCOMM.COMMANDTEXT = "DELUSERALL" '指定儲存進程名
MYCOMM.COMMANDTYPE = 4 '表明這是一個儲存進程
MYCOMM.PREPARED = TRUE '要求將SQL命令先行編譯
'聲明傳回值
SET MYPARA = MYCOMM.CREATEPARAMETER("RETURN",2,4)
MYCOMM.PARAMETERS.APPEND MYPARA
MYCOMM.EXECUTE
'取得傳回值
DIM RETVALUE
RETVALUE = MYCOMM(0) '或RETVALUE = MYCOMM.PARAMETERS(0)
SET MYCOMM = NOTHING

在MYCOMM.CREATEPARAMETER("RETURN",2,4)中，各參數的含義如下：
第一個參數("RETURE")為參數名。參數名可以任意設定，但一般應與儲存進程中聲明的參數名相同。此處是傳回值，我習氣上設為"RETURE"；
第二個參數(2)，表明該參數的資料類型，具體的類型代碼請參閱ADO參考，以下給出常用的類型代碼：
ADBIGINT: 20 ;
ADBINARY : 128 ;
ADBOOLEAN: 11 ;
ADCHAR: 129 ;
ADDBTIMESTAMP: 135 ;
ADEMPTY: 0 ;
ADINTEGER: 3 ;
ADSMALLINT: 2 ;
ADTINYINT: 16 ;
ADVARCHAR: 200 ;
對於傳回值，只能取整形，且-1到-99為保留值；
第三個參數(4)，表明參數的性質，此處4表明這是一個傳回值。此參數取值的說明如下：
0 : 類型無法確定； 1: 輸入參數；2: 輸入參數；3：輸入或輸出參數；4: 傳回值

以上給出的ASP代碼，應該說是完整的代碼，也即最複雜的代碼，其實

SET MYPARA = MYCOMM.CREATEPARAMETER("RETURN",2,4)
MYCOMM.PARAMETERS.APPEND MYPARA

可以簡化為

MYCOMM.PARAMETERS.APPEND MYCOMM.CREATEPARAMETER("RETURN",2,4)

甚至還可以繼續簡化，稍後會做說明。
對於帶參數的儲存進程，只能使用COMMAND對象調用(也有資料說可通過CONNECTION對象或RECORDSET對象調用，但我沒有試成過)。
4. 有輸入參數和輸出參數的儲存進程
傳回值其實是一種特殊的輸出參數。在大多數情況下，我們用到的是同時有輸入及輸出參數的儲存進程，比如我們想取得使用者資訊表中，某ID使用者的使用者名稱，這時候，有一個輸入參數----使用者ID，和一個輸出參數----使用者名稱。實現這一功能的儲存進程如下：

/*SP4*/
CREATE PROCEDURE DBO.GETUSERNAME
@USERID INT,
@USERNAME VARCHAR(40) OUTPUT
AS
SET NOCOUNT ON
BEGIN
IF @USERID IS NULL RETURN
SELECT @USERNAME=USERNAME
FROM DBO.[USERINFO]
WHERE USERID=@USERID
RETURN
END
GO

調用該儲存進程的ASP代碼如下：

'**調用帶有輸入輸出參數的儲存進程**
DIM MYCOMM,USERID,USERNAME
USERID = 1
SET MYCOMM = SERVER.CREATEOBJECT("ADODB.COMMAND")
MYCOMM.ACTIVECONNECTION = MYCONSTR 'MYCONSTR是資料庫連接字串
MYCOMM.COMMANDTEXT = "GETUSERNAME" '指定儲存進程名
MYCOMM.COMMANDTYPE = 4 '表明這是一個儲存進程
MYCOMM.PREPARED = TRUE '要求將SQL命令先行編譯
'聲明參數
MYCOMM.PARAMETERS.APPEND MYCOMM.CREATEPARAMETER("@USERID",3,1,4,USERID)
MYCOMM.PARAMETERS.APPEND MYCOMM.CREATEPARAMETER("@USERNAME",200,2,40)
MYCOMM.EXECUTE
'取得出參
USERNAME = MYCOMM(1)
SET MYCOMM = NOTHING

在以上代碼中，可以看到，與聲明傳回值不同，聲明輸入參數時需要5個參數，聲明輸出參數時需要4個參數。聲明輸入參數時5個參數分別為：參數名、參數資料類型、參數類型、資料長度、參數值。聲明輸出參數時，沒有最後一個參數：參數值。
需要特別注意的是：在聲明參數時，順序一定要與儲存進程中定義的順序相同，而且各參數的資料類型、長度也要與儲存進程中定義的相同。
如果儲存進程有多個參數，ASP代碼會顯得繁瑣，可以使用WITH命令簡化代碼：

'**調用帶有輸入輸出參數的儲存進程(簡化代碼)**
DIM MYCOMM,USERID,USERNAME
USERID = 1
SET MYCOMM = SERVER.CREATEOBJECT("ADODB.COMMAND")
WITH MYCOMM
.ACTIVECONNECTION = MYCONSTR 'MYCONSTR是資料庫連接字串
.COMMANDTEXT = "GETUSERNAME" '指定儲存進程名
.COMMANDTYPE = 4 '表明這是一個儲存進程
.PREPARED = TRUE '要求將SQL命令先行編譯
.PARAMETERS.APPEND .CREATEPARAMETER("@USERID",3,1,4,USERID)
.PARAMETERS.APPEND .CREATEPARAMETER("@USERNAME",200,2,40)
.EXECUTE
END WITH
USERNAME = MYCOMM(1)
SET MYCOMM = NOTHING

假如我們要取得ID為1到10，10位使用者的使用者名稱，是不是要建立10次COMMAND對象呢？不是的。如果需要多次調用同一儲存進程，只需改變輸入參數，就會得到不同的輸出：

'**多次調用同一儲存進程**
DIM MYCOMM,USERID,USERNAME
USERNAME = ""
SET MYCOMM = SERVER.CREATEOBJECT("ADODB.COMMAND")
FOR USERID = 1 TO 10
WITH MYCOMM
.ACTIVECONNECTION = MYCONSTR 'MYCONSTR是資料庫連接字串
.COMMANDTEXT = "GETUSERNAME" '指定儲存進程名
.COMMANDTYPE = 4 '表明這是一個儲存進程
.PREPARED = TRUE '要求將SQL命令先行編譯
IF USERID = 1 THEN
.PARAMETERS.APPEND .CREATEPARAMETER("@USERID",3,1,4,USERID)
.PARAMETERS.APPEND .CREATEPARAMETER("@USERNAME",200,2,40)
.EXECUTE
ELSE
'重新給入參賦值(此時參數值不發生變化的入參以及出參不必重新聲明)
.PARAMETERS("@USERID") = USERID
.EXECUTE
END IF
END WITH
USERNAME = USERNAME + MYCOMM(1) + "," '也許你喜歡用數組儲存
NEXT
SET MYCOMM = NOTHING

通過以上代碼可以看出：重複調用同一儲存進程時，只需為值發生改變的輸入參數重新賦值即可，這一方法在有多個輸入輸出參數，且每次調用時只有一個輸入參數的值發生變化時，可以大大減少代碼量。

5. 同時具有傳回值、輸入參數、輸出參數的儲存進程
前面說過，在調用儲存進程時，聲明參數的順序要與儲存進程中定義的順序相同。還有一點要特別注意：如果儲存進程同時具有傳回值以及輸入、輸出參數，傳回值要最先聲明。
為了示範這種情況下的調用方法，我們改善一下上面的例子。還是取得ID為1的使用者的使用者名稱，但是有可能該使用者不具有(該使用者已刪除，而USERID是自增長的欄位)。儲存進程根據使用者具有與否，返回不同的值。此時，儲存進程和ASP代碼如下：

/*SP5*/
CREATE PROCEDURE DBO.GETUSERNAME
--為了加深對"順序"的印象，將以下兩參數的定義順序顛倒一下
@USERNAME VARCHAR(40) OUTPUT,
@USERID INT
AS
SET NOCOUNT ON
BEGIN
IF @USERID IS NULL RETURN
SELECT @USERNAME=USERNAME
FROM DBO.[USERINFO]
WHERE USERID=@USERID
IF @@ROWCOUNT>0
RETURN 1
ELSE
RETURN 0
RETURN
END
GO

'**調用同時具有傳回值、輸入參數、輸出參數的儲存進程**
DIM MYCOMM,USERID,USERNAME
USERID = 1
SET MYCOMM = SERVER.CREATEOBJECT("ADODB.COMMAND")
WITH MYCOMM
.ACTIVECONNECTION = MYCONSTR 'MYCONSTR是資料庫連接字串
.COMMANDTEXT = "GETUSERNAME" '指定儲存進程名
.COMMANDTYPE = 4 '表明這是一個儲存進程
.PREPARED = TRUE '要求將SQL命令先行編譯
'傳回值要最先被聲明
.PARAMETERS.APPEND .CREATEPARAMETER("RETURN",2,4)
'以下兩參數的聲明順序也做相應顛倒
.PARAMETERS.APPEND .CREATEPARAMETER("@USERNAME",200,2,40)
.PARAMETERS.APPEND .CREATEPARAMETER("@USERID",3,1,4,USERID)
.EXECUTE
END WITH
IF MYCOMM(0) = 1 THEN
USERNAME = MYCOMM(1)
ELSE
USERNAME = "該使用者不具有"
END IF
SET MYCOMM = NOTHING
6. 同時返回參數和記錄集的儲存進程
有時候，我們需要儲存進程同時返回參數和記錄集，比如在利用儲存進程分頁時，要同時返回記錄集以及資料總量等參數。以下給出一個進行分頁處理的儲存進程：

/*SP6*/
CREATE PROCEDURE DBO.GETUSERLIST
@IPAGECOUNT INT OUTPUT, --總頁數
@IPAGE INT, --當前頁號
@IPAGESIZE INT --每頁記錄數
AS
SET NOCOUNT ON
BEGIN
--建立暫存資料表
CREATE TABLE #T (ID INT IDENTITY, --自增欄位
USERID INT,
USERNAME VARCHAR(40))
--向暫存資料表中寫入資料
INSERT INTO #T
SELECT USERID,USERNAME FROM DBO.[USERINFO]
ORDER BY USERID

--取得記錄總數
DECLARE @IRECORDCOUNT INT
SET @IRECORDCOUNT = @@ROWCOUNT

--確定總頁數
IF @IRECORDCOUNT%@IPAGESIZE=0
SET @IPAGECOUNT=CEILING(@IRECORDCOUNT/@IPAGESIZE)
ELSE
SET @IPAGECOUNT=CEILING(@IRECORDCOUNT/@IPAGESIZE)+1

--若請求的頁號大於總頁數，則顯示最後一頁
IF @IPAGE > @IPAGECOUNT
SELECT @IPAGE = @IPAGECOUNT

--確定當前頁的始末記錄
DECLARE @ISTART INT --START RECORD
DECLARE @IEND INT --END RECORD
SELECT @ISTART = (@IPAGE - 1) * @IPAGESIZE
SELECT @IEND = @ISTART + @IPAGESIZE + 1

--取當前頁記錄
SELECT * FROM #T WHERE ID>@ISTART AND ID<@IEND

--刪除暫存資料表
DROP TABLE #T

--返回記錄總數
RETURN @IRECORDCOUNT
END
GO

在上面的儲存進程中，輸入當前頁號及每頁記錄數，返回當前頁的記錄集，總頁數及記錄總數。為了更具典型性，將記錄總數以傳回值的形式返回。以下是調用該儲存進程的ASP代碼(具體的分頁操作略去):

'**調用分頁儲存進程**
DIM PAGENOW,PAGESIZE,PAGECOUNT,RECORDCOUNT
DIM MYCOMM,MYRST
PAGENOW = REQUEST("PN")
'自訂函數用於驗證自然數
IF CHECKNAR(PAGENOW) = FALSE THEN PAGENOW = 1
PAGESIZE = 20
SET MYCOMM = SERVER.CREATEOBJECT("ADODB.COMMAND")
WITH MYCOMM
.ACTIVECONNECTION = MYCONSTR 'MYCONSTR是資料庫連接字串
.COMMANDTEXT = "GETUSERLIST" '指定儲存進程名
.COMMANDTYPE = 4 '表明這是一個儲存進程
.PREPARED = TRUE '要求將SQL命令先行編譯
'傳回值(記錄總量)
.PARAMETERS.APPEND .CREATEPARAMETER("RETURN",2,4)
'出參(總頁數)
.PARAMETERS.APPEND .CREATEPARAMETER("@IPAGECOUNT",3,2)
'入參(當前頁號)
.PARAMETERS.APPEND .CREATEPARAMETER("@IPAGE",3,1,4,PAGENOW)
'入參(每頁記錄數)
.PARAMETERS.APPEND .CREATEPARAMETER("@IPAGESIZE",3,1,4,PAGESIZE)
SET MYRST = .EXECUTE
END WITH
IF MYRST.STATE = 0 THEN '未取到資料，MYRST關閉
RECORDCOUNT = -1
ELSE
MYRST.CLOSE '注意：若要取得參數值，需先關閉記錄集對象
RECORDCOUNT = MYCOMM(0)
PAGECOUNT = MYCOMM(1)
IF CINT(PAGENOW)>=CINT(PAGECOUNT) THEN PAGENOW=PAGECOUNT
END IF
SET MYCOMM = NOTHING

'以下顯示記錄
IF RECORDCOUNT = 0 THEN
RESPONSE.WRITE "無記錄"
ELSEIF RECORDCOUNT > 0 THEN
MYRST.OPEN
DO UNTIL MYRST.EOF
......
LOOP
'以下顯示分頁資訊
......
ELSE 'RECORDCOUNT=-1
RESPONSE.WRITE "參數錯誤"
END IF

對於以上代碼，只有一點需要說明：同時返回記錄集和參數時，若要取得參數，需先將記錄集關閉，使用記錄集時再將其開啟。

7. 返回多個記錄集的儲存進程
本文最先介紹的是返回記錄集的儲存進程。有時候，需要一個儲存進程返回多個記錄集，在ASP中，如何同時取得這些記錄集呢？為了說明這一問題，在USERINFO表中增加兩個欄位：USERTEL及USERMAIL，並設定只有登入使用者可以查看這兩項內容。

/*SP7*/
CREATE PROCEDURE DBO.GETUSERINFO
@USERID INT,
@CHECKLOGIN BIT
AS
SET NOCOUNT ON
BEGIN
IF @USERID IS NULL OR @CHECKLOGIN IS NULL RETURN
SELECT USERNAME
FROM DBO.[USRINFO]
WHERE USERID=@USERID
--若為登入使用者，取USERTEL及USERMAIL
IF @CHECKLOGIN=1
SELECT USERTEL,USERMAIL
FROM DBO.[USERINFO]
WHERE USERID=@USERID
RETURN
END
GO

以下是ASP代碼：

'**調用返回多個記錄集的儲存進程**
DIM CHECKLG,USERID,USERNAME,USERTEL,USERMAIL
DIM MYCOMM,MYRST
USERID = 1
'CHECKLOGIN()為自訂函數，判斷訪問者是否登入
CHECKLG = CHECKLOGIN()
SET MYCOMM = SERVER.CREATEOBJECT("ADODB.COMMAND")
WITH MYCOMM
.ACTIVECONNECTION = MYCONSTR 'MYCONSTR是資料庫連接字串
.COMMANDTEXT = "GETUSERINFO" '指定儲存進程名
.COMMANDTYPE = 4 '表明這是一個儲存進程
.PREPARED = TRUE '要求將SQL命令先行編譯
.PARAMETERS.APPEND .CREATEPARAMETER("@USERID",3,1,4,USERID)
.PARAMETERS.APPEND .CREATEPARAMETER("@CHECKLOGIN",11,1,1,CHECKLG)
SET MYRST = .EXECUTE
END WITH
SET MYCOMM = NOTHING

'從第一個記錄集中取值
USERNAME = MYRST(0)
'從第二個記錄集中取值
IF NOT MYRST IS NOTHING THEN
SET MYRST = MYRST.NEXTRECORDSET()
USERTEL = MYRST(0)
USERMAIL = MYRST(1)
END IF
SET MYRST = NOTHING

以上代碼中，利用RECORDSET對象的NEXTRECORDSET方法，取得了儲存進程返回的多個記錄集。

至此，針對ASP調用儲存進程的各種情況，本文已做了較為全面的說明。最後說一下在一個ASP程式中，調用多個儲存進程的不同方法。
在一個ASP程式中，調用多個儲存進程至少有以下三種方法是可行的：
1. 建立多個COMMAND對象

DIM MYCOMM
SET MYCOMM = SERVER.CREATEOBJECT("ADODB.COMMAND")
'調用儲存進程一
......
SET MYCOMM = NOTHING
SET MYCOMM = SERVER.CREATEOBJECT("ADODB.COMMAND")
'調用儲存進程二
......
SET MYCOMM = NOTHING
......

2. 只建立一個COMMAND對象，結束一次調用時，清除其參數

DIM MYCOMM
SET MYCOMM = SERVER.CREATEOBJECT("ADODB.COMMAND")
'調用儲存進程一
.....
'清除參數(假設有三個參數)
MYCOMM.PARAMETERS.DELETE 2
MYCOMM.PARAMETERS.DELETE 1
MYCOMM.PARAMETERS.DELETE 0
'調用儲存進程二並清除參數
......
SET MYCOMM = NOTHING

此時要注意：清除參數的順序與參數聲明的順序相反，原因嘛，我也不知道。

3. 利用PARAMETERS資料集合的REFRESH方法重設PARAMETER對象

DIM MYCOMM
SET MYCOMM = SERVER.CREATEOBJECT("ADODB.COMMAND")
'調用儲存進程一
.....
'重設PARAMETERS資料集合中包含的所有PARAMETER對象
MYCOMM.PARAMETERS.REFRESH
'調用儲存進程二
.....
SET MYCOMM = NOTHING

一般以為，重複建立對象是效率較低的一種方法，但是經測試(測試載入器為MICROSOFT APPLICATION CENTER TEST)，結果出人意料：
方法2 >= 方法1 >> 方法3
方法2的運行速度大於等於方法1(最多可高4%左右)，這兩種方法的運行速度遠大於方法3(最多竟高達130%)，所以建議在參數多時，採用方法1，在參數較少時，採用方法2。

花了一天的時間，終於把我對於在ASP中調用儲存進程的一些粗淺的經驗形成了文字。這其中，有些是我只知其果而不明其因的，有些可能是錯誤的，但是，這些都是經過我親身實踐的。各位看官批判地接受吧。有不同意見，希望一定向我指明，先謝了.