共用方式為

結果集範例

  • 發行項

更新： 2006 年 7 月 17 日

有時，在閱讀查詢結果時，它對能夠在不開啟新連接也不將所有結果讀取到記憶體中的情況下執行命令會很有用。ADO.NET 2.0 中的 Multiple Active Result Set (MARS) 功能是一種可以協助您實現此目的之技術。目前，不會對用於伺服器端程式設計的同處理序提供者實作 MARS。若要解決此限制，您可以使用伺服器端指標。此範例示範如何使用伺服器端指標解決伺服器端程式設計不支援 MARS 的問題。

ms160831.note(zh-tw,SQL.90).gif附註：
使用伺服器端指標會耗用大量伺服器資源，有時可能會使 Microsoft SQL Server 中的查詢最佳化工具無法提升查詢的效能。因此，在可能的情況下請盡量考慮重新撰寫程式碼而改用 JOIN。

此類別的 API 類似於資料讀取器，不同之處在於您可以在結果集中向前或向後移動，並可在結果集開啟時，對該連接發出其他命令。

已高度簡化此實作，方便您理解範例。更為有效的實作會提取多個資料列，從而減少每次提取資料列時的資料庫週轉

使用此類別耗用的記憶體使用量將遠小於用查詢的所有結果填滿資料集所耗用的記憶體使用量，這對伺服器端程式設計來說非常重要。

此範例還會示範使用 "Allow partially trusted callers" 屬性，指示結果集組件為程式庫，並且可以從其他組件安全地呼叫。這個方法稍微複雜，但是比使用 unsafe 權限註冊呼叫組件更安全。之所以較為安全，是因為將呼叫組件註冊為 safe，呼叫組件會限制存取出影響伺服器的資源，並且避免損壞伺服器的完整性。

安裝目錄：

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

Engine\Programmability\CLR\ResultSet\

狀況

Jane 是 Adventure Works Cycles 的開發人員。她必須撰寫在從她的伺服器端查詢傳回所有資料之前讀取資料並執行其他動作的軟體。

語言

Transact-SQL、Visual C# 和 Visual Basic。

功能

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

應用程式區 功能

整體

CLR、伺服器端指標、Transact-SQL

必要條件

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

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

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

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

    sn -k SampleKey.snk

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

若要建立 ResultSet 範例

  1. 編譯範例的方法為使用 Visual Studio 2005 和所提供的 Visual Studio 方案，或使用包含在 .NET Framework SDK 2.0 中的 Microsoft MSBuild。請在命令提示字元中執行如下命令：

    msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\ ResultSet.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

執行範例

若要執行 ResultSet 範例

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

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

移除範例

若要移除 ResultSet 範例

  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 資料庫或報表伺服器上，連接或使用範例應用程式及組件。

請參閱

其他資源

Allowing Partially Trusted Callers

說明及資訊

取得 SQL Server 2005 協助

變更歷程記錄

版本 歷程記錄

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

2006 年 7 月 17 日
新增內容：
  • 新增了描述安全性問題的內容。