共用方式為


使用者自訂資料類型 (UDT) 範例

更新: 2005 年 12 月 5 日

UserDefinedDataType 範例顯示從 Transact-SQL 和使用 System.Data.SqlClient 的用戶端應用程式建立及使用簡單的使用者自訂資料類型。

預設安裝目錄為 <drive>:\Program Files\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\UserDefinedDataType。

狀況

開發人員要表示、保存和管理複雜數字。

語言

Transact-SQL、Visual C# 和 Visual Basic。

功能

UserDefinedDataType 範例使用下列 SQL Server 2005 功能:

應用程式區 功能

整體

CLR

必要條件

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

  • 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),將命令提示字元視窗的現行目錄切換到範例的安裝資料夾。

    ms160738.note(zh-tw,SQL.90).gif附註:
    若要判斷範例所在的資料夾,按一下 [開始] 按鈕,依序指向 [所有程式]、[Microsoft SQL Server] 和 [文件集和教學課程],然後按一下 [範例目錄]。如果是使用預設安裝位置,則範例位於 <system_drive>:\Program Files\Microsoft SQL Server\100\Samples。
  3. 在命令提示字元中,執行下列其中一個命令來產生金鑰檔:

    sn -k SampleKey.snk

    ms160738.note(zh-tw,SQL.90).gif重要事項:
    如需有關強式名稱金鑰組的詳細資訊,請參閱 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) 來編譯範例。在命令提示字元中執行下列命令:

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

  2. 請確定已安裝 AdventureWorks 資料庫,或在必要時建立要安裝範例的資料庫。

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

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

    此檔案包含用於安裝及註冊 SQL Server 中 SQL CLR UDT 範例的指令碼。

執行範例

若要執行範例,請執行下列動作:

執行範例

  1. 在 SQL Server Management Studio 開啟 scripts\test.sql 檔案,並執行該檔案所包含的指令碼。或者,在命令提示字元中執行下列命令:

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

    此指令碼會叫用 Transact-SQL 的範例 SQL CLR UDT 物件。

  2. 執行 clientsample.exe,從命令列指定其中安裝了範例使用者自訂資料類型的資料庫名稱。此範例主控台應用程式會使用 System.Data.SqlClient 來叫用範例使用者自訂資料類型。

移除範例

若要移除範例,請執行下列動作:

移除範例

  1. 在 SQL Server Management Studio 開啟 scripts\cleanup.sql 檔案,並執行該檔案所包含的指令碼。或者,在命令提示字元中執行下列命令:

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

    此指令碼會移除 UDT 範例。

註解

必須啟用 SQL Server 2005 或 SQL Server Express 的 CLR,才能讓此範例正常運作。

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

請參閱

概念

CLR 可程式性範例

說明及資訊

取得 SQL Server 2005 協助

變更歷程記錄

版本 歷程記錄

2005 年 12 月 5 日

變更的內容:
  • 已變更產生金鑰檔的指示,包括金鑰檔的名稱和位置。