自定义报表项示例

项目
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 开发中心中的“安全简讯：.NET Framework 中的强名称和安全性”。

重要事项：
有关强名称密钥对的详细信息，请参阅 MSDN 上 .NET 开发中心中的“安全简讯：.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>

将 PolygonsCRI.dll 文件从复制示例项目的 \PolygonCRI\Bin\Debug 目录复制到 Visual Studio 专用程序集目录（默认为 \Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies）。
将 PolygonsCRI.dll 文件从复制示例项目的 \PolygonCRI \Bin\Debug 目录复制到 Microsoft SQL Server Reporting Services bin 目录（默认为 \Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\Bin）。
将 PolygonsDesigner.dll 文件从 \PolygonDesigner\Bin\Debug 目录复制到 Visual Studio 专用程序集目录（默认为 \Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies）。

运行示例

本部分包含一个快速演练，其中说明如何在 Visual Studio 中引用 Polygon 自定义报表项并对其进行测试。

将 PolygonDesigner 添加到 Visual Studio 工具箱

在 Visual Studio 工具箱中单击右键。
选中**“选择项”**。
导航到 \Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies 文件夹并选择 PolygonsDesigner.dll。

运行示例

在 Visual Studio 中打开 \PolygonsReport\Polygons.sln 示例报表项目。
单击示例报表中的**“预览”**选项卡，或将示例报表部署到服务器并运行。

若要使用 Visual Studio 中的 PolygonDesigner 自定义控件来编辑报表，可以执行以下操作之一：

在属性浏览器中设置多边形控件的属性。
通过控件的上下文菜单编辑属性。
将字段从字段列表拖放到控件的拖放区域。
选择图表，并在上下文菜单中选择**“转换为多边形”**。

请参阅

通过

自定义报表项示例

要求

位置

生成示例

生成强名称密钥文件

生成 PolygonsCRI 示例

部署示例

部署 PolygonsCRI 示例

运行示例

将 PolygonDesigner 添加到 Visual Studio 工具箱

运行示例

请参阅

任务

其他资源

帮助和信息

其他资源