通常，開發人員使用的是T-SQL來建立SQL Server的儲存過程、函式和觸發器。而現在的SQL Server 2005已經完全支援.NET通用語言執行時（CLR）了。這就意味著，你可以使用.NET的語言，如C#、VB.NET之類的來開發SQL Server的儲存過程、函式和觸發器。 SQL Server 和 CLR 的整合給我們帶來了n多好處，如實時編譯、型別安全、增強的安全性以及增強的程式設計模型等。本文中，我將向大家演示如何使用C#建立SQL Server的儲存過程。

背景

我們在使用SQL Server儲存過程時，最常做的工作就是從資料庫中讀取或儲存資料。其常用應用如下：

◆執行一些簡單的邏輯，沒有任何返回值。

為了演示如何用C#開發出這幾種應用的SQL Server儲存過程，我將一個一個地舉出示例。

啟用CLR整合

在你開始用C#寫儲存過程之前，必須要啟用你的SQL Server的CLR整合特性。預設情況它是不啟用的。開啟你的SQL Server Management Studio並執行如下指令碼。

sp_configure 'clr enabled', 1
GO
RECONFIGURE
GO

這裡，我們執行了系統儲存過程“sp_configure”，為其提供的兩個引數分別為：“clr enabled”和“1”。如果要停用CLR整合的話也是執行這個儲存過程，只不過第二個引數要變為“0”而已。另外，為了使新的設定產生效果，不要忘記呼叫“RECONFIGURE”。

SQL Server專案

現在開啟Visual Studio，並從檔案選單中選擇“新建專案”。在“新建專案”對話方塊中選擇“Visual C#”下的“Database”。然後選擇“SQL Server專案”模板。

起好專案名稱後就單擊“確定”按鈕。

很快，你所建立的專案就要求你選擇一個SQL Server資料庫。

按照提示一步一步地做就好了，就算你選擇了取消，也可以在

接下來，右鍵單擊你新建的這個專案，選擇“新增”-“儲存過程”。然後將會出現如下圖所示的對話方塊：

選擇“儲存過程”模板，並起一個合適的名字，然後單擊“新增”按鈕。

新增完後你就會發現，實際上這是建立了一個已經匯入了需要用到的名稱空間的類。

using System;
using System.Data;
using System.Data.SqlClient;
using System.Data.SqlTypes;
using Microsoft.SqlServer.Server;

注意一下加粗顯示的名稱空間（譯者注：後兩個using）。 System.Data.SqlTypes名稱空間包含了很多不同的型別，它們可以用來代替SQL Server的資料型別。 Microsoft.SqlServer.Server名稱空間下的類負責SQL Server的CLR整合。

說明：本程式操作“北風貿易”資料庫，“訂貨主檔”表，表內含有的欄位依次是：訂單號碼(int)，送貨城市(nvarchar(15)) …其他欄位省略。

沒有返回值的儲存過程

在這一節中，我們將會看到如何寫一個執行了一些邏輯，但是卻沒有任何返回值和輸出引數的儲存過程。在這個例子裡，我們將建立一個名為“ChangeCityName”的儲存過程，它用來修改“訂貨主檔”表中“送貨城市”欄位的值。這個儲存過程需要兩個引數 –ID（需要更改“送貨城市”的“訂單號碼”ID）和City（新的“送貨城市”）。 “ChangeCityName”儲存過程完成後的程式碼如下：（Procedure1）

[Microsoft.SqlServer.Server.SqlProcedure]

public static void ChangeCityName(SqlInt32 ID, SqlStringCity)

{

// 在此處放置程式碼

SqlConnection con = new SqlConnection("context connection = true");

con.Open();

SqlCommand cmd = new SqlCommand();

cmd.Connection = con;

cmd.CommandText = "update 訂貨主檔 set 送貨城市[email protected] where 訂單號碼[email protected]";

SqlParameter p1 = new SqlParameter("@City", City);

SqlParameter p2 = new SqlParameter("@ID", ID);

cmd.Parameters.Add(p1);

cmd.Parameters.Add(p2);

int row = cmd.ExecuteNonQuery();

con.Close();

SqlContext.Pipe.Send(row.ToString());

}

};

仔細看一下這個ChangeCityName ()方法。它是一個靜態方法並且沒有返回值（void）。它需要兩個名為ID和City的引數。請注意這兩個引數的資料型別是SqlInt32和SqlString。 SqlString可以用來代替SQL Server中的nvarchar資料型別。這個方法用了一個[SqlProcedure]屬性來修飾。該屬性用於標記ChangeCityName()方法是一個SQL Server儲存過程。

在方法內我們建立了一個SqlConnection物件，並設定其連線字串為“context connection = true”。 “上下文連線”可以讓你使用當前登入到資料庫的使用者作為你的登入資料庫的驗證資訊。本例中，ChangeCityName()方法將會轉換為儲存過程，然後儲存到“北風貿易”資料庫裡。所以在這裡的“上下文連線”指的就是“北風貿易”資料庫。這樣你就不需要再寫任何關於登入資料庫的驗證資訊了。

接下來是開啟資料庫連線。然後通過設定SqlCommand物件的Connection和CommandText屬性，讓其執行更新操作。同時，我們還需要設定兩個引數。這樣通過呼叫ExecuteNonQuery()方法就可以執行更新操作了。再接下來就是關閉連線。

最後，將ExecuteNonQuery()方法的返回值傳送到客戶端。當然你也可以不做這一步。現在我們來了解一下SqlContext類的使用。 SqlContext類用於在服務端和客戶端之間傳遞處理結果。本例使用了Send()方法傳送一個字串返回給呼叫者。

返回從表中讀取的一條或多條記錄的儲存過程

我們在使用儲存過程時，經常會SELECT一條或多條記錄。你可以採用兩種方法來建立這樣的儲存過程。

首先我們建立一個名為GetAllCustomers()的方法，程式碼如下：（Procedure2.1）

[Microsoft.SqlServer.Server.SqlProcedure]

public static void GetAllInfo()

{

SqlConnection con = new SqlConnection("context connection = true");

SqlCommand cmd = new SqlCommand();

cmd.Connection = con;

cmd.CommandText = "Select * from 訂貨主檔";

con.Open();

SqlDataReader reader = cmd.ExecuteReader();

SqlContext.Pipe.Send(reader);

reader.Close();

con.Close();

}

這個GetAllInfo ()方法用了一個[SqlProcedure]屬性來修飾。在方法內建立一個SqlConnection和一個SqlCommand物件。然後使用ExecuteReader()方法來執行SELECT語句。接下來用Send()方法將取得的SqlDataReader資料傳送到客戶端。最後就是關閉SqlDataReader和SqlConnection。在這種方法中，是我們自己建立的SqlDataReader。

其實，我們也可以把這個任務交給SqlContext類去完成，程式碼如下：（Procedure2.2）

[Microsoft.SqlServer.Server.SqlProcedure]

public static void GetAllInfoByID(SqlInt32 ID)

{

SqlConnection con = new SqlConnection("context connection=true");

con.Open();

SqlCommand cmd = new SqlCommand();

cmd.Connection = con;

cmd.CommandText = "select * from 訂貨主檔 where 訂單號碼[email protected]";

SqlParameter p1 = new SqlParameter("@p1", ID);

cmd.Parameters.Add(p1);

SqlContext.Pipe.ExecuteAndSend(cmd);

con.Close();

}

GetAllInfoByID ()方法需要一個引數 –ID，它將從“訂貨主檔”表中返回某行的記錄。這個方法內的程式碼，除了ExecuteAndSend()方法外，你應該都已經比較熟悉了。 ExecuteAndSend()方法接收一個SqlCommand物件作為引數，執行它就會返回資料集給客戶端。

有輸出引數的儲存過程

我們在使用儲存過程時，經常會通過輸出引數返回一個經過計算的值。所以，現在讓我們來看一看如何建立具有一個或多個輸出引數的儲存過程。（Procedure3）

[Microsoft.SqlServer.Server.SqlProcedure]

public static void GetCityName(SqlInt32 ID, out SqlStringCity)

{

SqlConnection con = new SqlConnection("context connection=true");

con.Open();

SqlCommand cmd = new SqlCommand();

cmd.Connection = con;

cmd.CommandText = "Select送貨城市 from訂貨主檔 where訂單號碼[email protected]";

SqlParameter id = new SqlParameter("@ID", ID);

cmd.Parameters.Add(id);

object obj = cmd.ExecuteScalar();

con.Close();

City = obj.ToString();

}

這是一個名為GetCityName ()的方法，它需要兩個引數。第一個引數是ID，它是一個輸入引數；第二個引數是City，它是一個輸出引數（用關鍵字out來指明）。這兩個引數是SqlInt32和SqlString型別的。GetCityName ()方法會接收一個ID引數，然後返回City（作為輸出引數）。

該方法內的程式碼首先設定了SqlConnection和SqlCommand物件。然後，使用ExecuteScalar()方法來執行SELECT語句。 ExecuteScalar()方法返回的值是一個object型別，它其實就是公司名稱。最後將輸出引數City設定為這個值。

返回一行或多行自定義資料的儲存過程

我們在使用儲存過程時，更多的還是從某些表中讀取資料。但是，某些情況下我們需要的資料可能不在任何表裡。例如，你可能會基於某些計算來生成一個數據表格。因為它的資料不是從表中獲得的，所以上面的方法就不在適用了。幸運的是，SQL Server的CLR整合特性給我們提供了一個解決這個問題的方法。請看如下程式碼：（Procedure4.1）

[Microsoft.SqlServer.Server.SqlProcedure]

public static void GetRow()

{

SqlMetaData[] metadata = new SqlMetaData[2];

metadata[0] = new SqlMetaData("ID", SqlDbType.Int);

metadata[1] = new SqlMetaData("City", SqlDbType.NVarChar, 15);

SqlDataRecord record = new SqlDataRecord(metadata);

record.SetInt32(0, 10248);

record.SetString(1, "北京市");

SqlContext.Pipe.Send(record);

}

GetRow()方法會返回一條記錄併發送給客戶端。這個方法首先聲明瞭一個SqlMetaData物件。當你要用到自定義列的時候，就可以使用這個SqlMetaData類。在我們的示例中，建立了兩個型別為NVarChar，長度為15的列。然後建立了一個SqlDataRecord物件。 SqlDataRecord類可以用來表示一個自定義行。它的建構函式需要一個SqlMetaData陣列作為引數。 SqlDataRecord物件的SetString()方法用來設定列的值。另外，還有許多不同的類似SetString()這樣的方法，可以用來處理不同的資料型別。最後，呼叫Send()方法將SqlDataRecord物件傳送到客戶端。

在上面的示例中，我們只返回了一行資料給呼叫者。那麼，如果要返回多行呢？請看下面的程式碼：（Procedure4.2）

[Microsoft.SqlServer.Server.SqlProcedure]

public static void GetMultipleRow()

{

SqlMetaData[] metadata = new SqlMetaData[2];

metadata[0] = new SqlMetaData("ID", SqlDbType.Int);

metadata[1] = new SqlMetaData("City", SqlDbType.NVarChar, 15);

SqlDataRecord record = new SqlDataRecord(metadata);

SqlContext.Pipe.SendResultsStart(record);

record.SetInt32(0, 10249);

record.SetString(1, "天津市");

SqlContext.Pipe.SendResultsRow(record);

record.SetInt32(0, 10250);

record.SetString(1, "天津市");

SqlContext.Pipe.SendResultsRow(record);

SqlContext.Pipe.SendResultsEnd();

}

GetMultipleRow()方法將會返回多個SqlDataRecord物件到客戶端。接下來建立自定義列和設定列的值都和之前的例子一樣。但是，我們使用的是SendResutlsStart()方法來傳輸資料。 SendResultsRow()方法也是傳送一個SqlDataRecord物件到客戶端，但是我們可以多次呼叫它，從而做到傳送多條記錄。最後，呼叫SendResultsEnd()方法用來標記已經完成資料傳輸操作。

我們已經開發完了儲存過程。現在就可以將這個專案編譯為一個程式集（.DLL）。但是我們的工作並沒有到此結束。我們還需要部署這個程式集和儲存過程到SQL Server資料庫。有兩種方法可以完成這個工作 – 手動和自動。手動方法是使用T-SQL語句註冊你的程式集，並將儲存過程部署到SQL Server資料庫中。在本例中，我將使用自動的方法來部署儲存過程到SQL Server資料庫。

右鍵單擊你的專案，然後在選單中選擇“部署”選項。

如此就會自動地完成註冊程式集和部署儲存過程的工作。注意，只有在你建立專案時添加了資料庫引用的時候，才會出現“部署”選項。如果因為某些原因你沒能新增資料庫引用，那麼你可以通過專案屬性對話方塊來設定它。

如果你在SQL Server Management Studio檢視Northwind資料庫的話，那麼就應該可以看到和下圖相似的結果。

注意，在儲存過程節點下出現了我們建立的所有方法（有“鎖”圖示的），並且在程式集節點下出現了我們的程式集。

就是這些東西，很簡單吧。現在你就可以在你的程式中呼叫這些儲存過程了。你也可以在SQL Server Management Studio中來測試它們。

作者簡介：Bipin Joshi是DotNetBips.com的管理員。他是的發起人，這個公司提供.NET framwork的培訓和諮詢服務。他在印度孟買為開發者提供培訓。他也是微軟的MVP(ASP.Net)和ASPInsiders的會員。