陣列參數範例

更新： 2006 年 4 月 14 日

有時，在資料庫中建立、更新或刪除一組資料列非常有用。您可以使用數種方法實現此目標。其中之一便是從用戶端將資訊的陣列，傳遞至使用 Common Language Runtime (CLR) 整合使用者自訂資料類型之伺服器上的 CLR 整合預存程序。此類使用者自訂資料類型的性質將提供給伺服器的資料大小限制在 8000 位元組。因此，此方法無法滿足大型或複雜的資料。如需詳細資訊，請參閱＜AdventureWorks Cycles CLR 層＞範例中的連絡人建立預存程序。如果管理的資料較小而且簡單，則相較於呼叫每一個資料列的預存程序，此方法會更有效。藉由傳遞陣列，對於順序重要的那些應用程式可保留資料的順序。

這個範例包含下列各項：

1. ContactTypeNames 使用者自訂資料類型。包含所要求之連絡人類型名稱的清單。
2. usp_EnsureContactTypeNames 預存程序，實作為 Microsoft Visual C# 或 Microsoft Visual Basic 方法。這會接受 ContactTypeNames 使用者自訂資料類型的執行個體，並在 Person.ContactType 資料表中插入可存放任何連絡人名稱的新資料列，這些連絡人名稱包含在該資料表所沒有的使用者自訂資料類型執行個體中。
3. TestArrayParameter 主控台應用程式。這會根據所傳入之命令列參數建立 ContactTypeNames 使用者自訂資料類型的執行個體，然後叫用 usp_EnsureContactTypeNames 預存程序，方法是將使用者自訂資料類型的執行個體作為參數進行傳遞。

安裝目錄：<drive>:\Program Files\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\ArrayParameter\

狀況

Jane 是 Adventure Works Cycles 的開發人員。她必須在資料表中插入一些簡單的資料列，但想要最小化資料庫週轉。

語言

Transact-SQL、Visual C# 和 Visual Basic。

功能

「陣列參數」範例使用 Microsoft 的下列功能。

必要條件

執行此範例之前，請確定已安裝下列軟體：

• Microsoft SQL Server 2005 或 Microsoft SQL Server 2005 Express Edition (SQL Server Express)。您可以從「SQL Server 2005 Express Edition 文件集和範例」網站中免費取得 SQL Server Express。
• SQL Server 2005 中包含的 AdventureWorks 資料庫，也可以從 SQL Server 開發人員網站取得。
• SQL Server 2005 Database Engine 範例。SQL Server 2005 中隨附這些範例。您可以從 SQL Server 開發人員網站下載最新版的範例。
• .NET Framework SDK 2.0 或 Microsoft Visual Studio 2005。您可以免費取得 .NET Framework SDK。請參閱＜安裝 .NET Framework SDK＞。

建立範例

如果您尚未建立強式名稱金鑰檔，請利用下列指示產生金鑰檔。

若要產生強式名稱金鑰檔

1. 開啟 Microsoft Visual Studio 2005 命令提示字元。按一下 [開始]，依序指向 [程式集] 和 [Microsoft .NET Framework SDK 2.0]，然後按一下 [SDK 命令提示字元]。

   -- 或 --

   開啟 Microsoft .NET Framework 命令提示字元。按一下 [開始]，依序指向 [所有程式] 和 [Microsoft .NET Framework SDK 2.0]，然後按一下 [SDK 命令提示字元]。

2. 使用變更目錄命令 (CD)，將命令提示字元視窗的現行目錄切換到範例的安裝資料夾。

   附註：
   若要判斷範例所在的資料夾，按一下 [開始] 按鈕，依序指向 [所有程式]、[Microsoft SQL Server] 和 [文件集和教學課程]，然後按一下 [範例目錄]。如果是使用預設安裝位置，則範例位於 <system_drive>:\Program Files\Microsoft SQL Server\100\Samples。

3. 在命令提示字元中，執行下列其中一個命令來產生金鑰檔：

   sn -k SampleKey.snk

   重要事項：
   如需有關強式名稱金鑰組的詳細資訊，請參閱 MSDN 中 .NET Development Center 中的＜Security Briefs: Strong Names and Security in the .NET Framework＞。

若要建立陣列參數範例

1. 使用 Visual Studio 2005 和已提供的 Visual Studio 方案，或使用 Microsoft MSBuild (隨附於 .NET Framework SDK 2.0) 來編譯範例。在 .NET Framework 命令提示字元中執行下列命令：

   msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\ArrayParameter.sln

2. 請確定已安裝 AdventureWorks 資料庫。

3. 如果您沒有在預設位置安裝 SQL Server Database Engine 範例，請修改 Scripts\InstallCS.sql 中指令碼之 CREATE ASSEMBLY 部分的路徑，以參考已安裝範例的位置。

4. 如果您不是正在使用之 SQL Server 執行個體的管理員，則必須讓管理員授與您 CreateAssembly 權限來完成安裝。

5. 在 SQL Server Management Studio 中，根據您所編譯的是 Visual C# 專案還是 Visual Basic 專案，來開啟 scripts\installCS.sql 或 scripts\installVB.sql 檔案。執行檔案中所包含的指令碼，或在命令提示字元視窗中執行如下命令：

   sqlcmd -E -I -i Scripts\InstallCS.sql

執行範例

若要執行陣列參數範例

1. 在命令提示字元中，使用變更目錄 (CD) 命令，將 [命令提示字元] 視窗的目前資料夾變更為 ArrayParameter 範例資料夾。在命令提示字元下，執行下列命令：

   Scripts\TestCS.cmd

移除範例

若要移除陣列參數範例

1. 在 Management Studio 中，開啟 scripts\cleanup.sql 檔案。執行檔案中所包含的指令碼，或在 [命令提示字元] 視窗中執行下列命令：

   sqlcmd -E -I -i Scripts\cleanup.sql

註解

必須啟用 SQL Server 2005 或 SQL Server Express 的 Common Language Runtime，這個範例才能順利運作。

範例只供教育目的之用。它們不能用於實際執行環境，而且尚未在實際執行環境中測試過。Microsoft 不提供對這些範例的技術支援。若沒有系統管理員的權限，就不應該在生產 SQL Server 資料庫或報表伺服器上，連接或使用範例應用程式及組件。

請參閱

工作

AdventureWorks Cycles CLR 層

說明及資訊

取得 SQL Server 2005 協助

變更歷程記錄