自訂報表項目範例

發行項
12/15/2008

新增： 2005 年 12 月 5 日

PolygonsCRI 是簡單的自訂報表項目範例。此範例使用 Microsoft .NET Framework 的 System.Component 類別和 Microsoft.ReportDesigner 與 Microsoft.ReportingServices 命名空間的類別，來實作可在報表產生器中使用的自訂報表項目執行時期元件和設計時期元件。

安裝期間不會自動安裝 SQL Server 範例。如需有關如何安裝範例的指示，請參閱＜安裝範例＞。

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

需求

您應該熟悉 Visual Studio 和 Microsoft Visual C#，而且您的系統必須符合下列需求，才能使用 PolygonsCRI 範例：

含 Reporting Services 的 Microsoft SQL Server 2005
Microsoft SQL Server Business Intelligence Development Studio。
Microsoft Visual Studio 2005。
Microsoft .NET Framework 2.0 版。

Reporting Services 範例。您有權限在網路存取的報表伺服器。

附註：
Itanium 電腦不支援 Business Intelligence (BI) Development Studio 和 Visual Studio 2005，不過仍支援 x64 電腦。如果您已經在 Itanium 電腦上部署 SQL Server 2005 範例資料庫，請在 x86 或 x64 電腦上使用 BI Development Studio 或 Visual Studio 來修改並執行範例。

位置

此範例位於 Reporting Services 範例目錄的 \Extension Samples\CustomReportItem Sample 子目錄。

例如：

C:\Program Files\Microsoft SQL Server\90\Samples\Reporting Services\Extension Samples\CustomReportItem Sample

建立範例

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

若要產生強式名稱金鑰檔

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

-- 或 --

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

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

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

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

sn -k SampleKey.snk

重要事項：

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

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

若要建立 PolygonsCRI 範例

在 Visual Studio 2005 中開啟 PolygonsCRI.sln 專案檔。
請從 [建立] 功能表上，選取 [建置方案]。
在 Visual Studio 中開啟 PolygonsCRI.sln 專案檔。

部署範例

若要部署 PolygonsCRI 範例

編輯 rsreportserver.config 來註冊 PolygonsCRI：

在 </Extensions> 之前插入下列幾行：

<ReportItems>
   <ReportItem Name="Polygons" Type="Microsoft.Samples.ReportingServices.PolygonsCCustomReportItem,PolygonsCRI"/>
</ReportItems>

編輯 rssrvpolicy.config 檔來加入自訂報表項目的程式碼群組：

加入下列幾行：

<CodeGroup 
   class="UnionCodeGroup" 
   version="1" 
   PermissionSetName="FullTrust"
   Description="This code group grants PolygonsCRI.dll FullTrust permission. ">
   <IMembershipCondition 
   class="UrlMembershipCondition"
   version="1"
   Url="C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin\PolygonsCRI.dll" />
</CodeGroup>

編輯 rsreportdesigner.config 檔來註冊執行時期元件、設計時期元件和項目類型轉換器：

在 </Extensions> 之前加入下列幾行：

<ReportItems>
   <ReportItem Name="Polygons" Type="Microsoft.Samples.ReportingServices.PolygonsCCustomReportItem,PolygonsCRI"/>
</ReportItems>
<ReportItemDesigner>
   <ReportItem Name="Polygons" Type=" Microsoft.Samples.ReportingServices.PolygonsDesigner, PolygonsDesigner" />
</ReportItemDesigner>
<ReportItemConverter>
   <Converter Source="Chart" Target="Polygons" Type=" Microsoft.Samples.ReportingServices.PolygonsConverter, PolygonsDesigner" />
</ReportItemConverter>

從您複製範例專案的 \PolygonCRI\Bin\Debug 目錄中，將 PolygonsCRI.dll 檔複製到 Visual Studio 專用組件目錄 (依預設為 \Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies)。
從您複製範例專案的 \PolygonCRI \Bin\Debug 目錄中，將 PolygonsCRI.dll 檔複製到 Microsoft SQL Server Reporting Services bin 目錄 (依預設為 \Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\Bin)。
從 \PolygonDesigner\Bin\Debug 目錄中，將 PolygonsDesigner.dll 檔複製到 Visual Studio 專用組件目錄 (依預設為 \Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies)。

執行範例

這一節包含快速逐步解說，顯示如何在 Visual Studio 中參考多邊形自訂報表項目及進行測試。

若要將 PolygonDesigner 加入 Visual Studio 工具箱中

以滑鼠右鍵按一下 Visual Studio 工具箱。
選取 [選擇項目]。
瀏覽至 \Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies 資料夾，並選取 [PolygonsDesigner.dll]。

若要執行範例

在 Visual Studio 中開啟 \PolygonsReport\Polygons.sln 範例報表專案。
按一下範例報表中的 [預覽] 索引標籤，或將範例報表部署到伺服器並執行範例報表。

若要在 Visual Studio 中使用 PolygonDesigner 自訂控制項來編輯報表，您可以執行下列任何一個動作：

在屬性瀏覽器中設定多邊形控制項的屬性。
透過控制項的內容功能表編輯屬性。
將欄位從欄位清單拖曳至控制項的卸除區域。
選取圖表，並在內容功能表中選擇 [轉換成多邊形]。

請參閱

共用方式為