共用方式為

日曆感知日期/時間 UDT

  • 發行項

更新： 2005 年 12 月 5 日

將日期儲存為字串可能會產生混淆，因為如果不瞭解正在使用的日曆系統為何，日期便沒有意義。

CADatetime 範例定義兩種使用者自訂資料類型 (CADatetime 和 CADate)，提供日期和時間的日曆感知處理。

安裝目錄：

<drive>:\Program Files\Microsoft SQL Server\90\Samples\Engine\Programmability\

CLR\CADateTime\

狀況

Jane 是 Adventure Works Cycles 的開發人員。必須撰寫處理全球日期和時間的軟體。她使用 CADatetime 和 CADate UDT 來協助在特殊日曆系統中表示日期。

語言

Transact-SQL、Visual C# 和 Visual Basic。

功能

CADatetime 範例使用 Microsoft SQL Server 的下列功能。

應用程式區 功能

UDT 實作

CLR

全球化整備

附屬組件

必要條件

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

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

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

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

    sn -k SampleKey.snk

    ms161559.note(zh-tw,SQL.90).gif重要事項：
    如需有關強式名稱金鑰組的詳細資訊，請參閱 MSDN 中 .NET Development Center 中的＜Security Briefs: Strong Names and Security in the .NET Framework＞。

若要建立 CADatetime 範例

  1. 透過在 SDK 命令提示字元視窗或 Visual Studio 命令提示字元視窗中執行下列命令，建立範例的資源檔：

    cd CS\CADateTime\resources

    build.cmd

    cd ..\..\..

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

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

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

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

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

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

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

執行範例

若要執行 CADatetime 範例

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

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

移除範例

若要移除 CADatetime 範例

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

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

註解

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

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

請參閱

工作

AdventureWorks Cycles CLR 層

說明及資訊

取得 SQL Server 2005 協助

變更歷程記錄

版本 歷程記錄

2005 年 12 月 5 日
變更的內容：
  • 已變更產生金鑰檔的指示，包括金鑰檔的名稱和位置。