Ejemplo de elemento de informe personalizado

Artículo
12/15/2008

Nuevo: 5 de diciembre de 2005

PolygonsCRI es un ejemplo de elemento de informe personalizado sencillo. Este ejemplo usa las clases de System.Component de Microsoft .NET Framework y las clases de los espacios de nombres Microsoft.ReportDesigner y Microsoft.ReportingServices para implementar un componente de tiempo de ejecución y un componente de tiempo de diseño de elemento de informe personalizado que se pueda usar en el Generador de informes.

Los ejemplos de SQL Server no se instalan de forma automática durante la instalación. Para obtener instrucciones acerca de la instalación de los ejemplos, vea el artículo sobre la instalación de los ejemplos.

Importante:
Los ejemplos se proporcionan exclusivamente con fines formativos. No se han diseñado para utilizarse en un entorno de producción y no se han probado en este tipo de entorno. Microsoft no ofrece soporte técnico para estos ejemplos. Las aplicaciones y los ensamblados de ejemplo no se deben conectar ni usar con la base de datos de SQL Server de producción ni con el servidor de informes sin el permiso del administrador del sistema.

Los ejemplos se proporcionan exclusivamente con fines formativos. No se han diseñado para utilizarse en un entorno de producción y no se han probado en este tipo de entorno. Microsoft no ofrece soporte técnico para estos ejemplos. Las aplicaciones y los ensamblados de ejemplo no se deben conectar ni usar con la base de datos de SQL Server de producción ni con el servidor de informes sin el permiso del administrador del sistema.

Requisitos

Para usar el ejemplo PolygonsCRI, debe saber usar Visual Studio y Microsoft Visual C#, y el sistema debe cumplir los requisitos siguientes:

Microsoft SQL Server 2005 con Reporting Services.
Microsoft SQL Server Business Intelligence Development Studio.
Microsoft Visual Studio 2005.
Microsoft .NET Framework versión 2.0.
Los ejemplos de Reporting Services. Un servidor de informes para el que tenga permisos de acceso en la red.

[!NOTA] Business Intelligence (BI) Development Studio y Visual Studio 2005 no son compatibles con los equipos basados en Itanium. Sin embargo, sí son compatibles con los equipos basados en x64. Si las bases de datos de ejemplo de SQL Server 2005 se han implementado en un equipo basado en Itanium, utilice BI Development Studio o Visual Studio en equipos basados en x86 o x64 para modificar y ejecutar los ejemplos.

Ubicación

Este ejemplo se encuentra en el subdirectorio \Extension Samples\CustomReportItem Sample del directorio de ejemplos de Reporting Services.

Por ejemplo:

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

Generar el ejemplo

Si aún no ha creado un archivo de clave de nombre seguro, genere este archivo mediante las siguientes instrucciones.

Para generar un archivo de clave de nombre seguro

Abra un símbolo del sistema de Microsoft Visual Studio 2005. Haga clic en Inicio, seleccione Todos los programas, Microsoft .NET Framework SDK 2.0 y, a continuación, haga clic en Símbolo del sistema de SDK.

-- O bien --

Abra un símbolo del sistema de Microsoft .NET Framework. Haga clic en Inicio, seleccione Todos los programas, Microsoft .NET Framework SDK 2.0 y, a continuación, haga clic en Símbolo del sistema de SDK.
Use el comando de cambio de directorio (CD) para cambiar el directorio actual a la carpeta donde están instalados los ejemplos.

[!NOTA] para determinar la carpeta donde se encuentran los ejemplos, haga clic en el botón Inicio, seleccione Todos los programas, Microsoft SQL Server, Documentación y tutoriales y, a continuación, haga clic en el directorio Ejemplos. Si se usó la ubicación de instalación predeterminada, los ejemplos se encontrarán en <unidadDeSistema>:\Archivos de programa\Microsoft SQL Server\100\Ejemplos.

En el símbolo del sistema, ejecute el comando siguiente para generar el archivo de clave:

sn -k SampleKey.snk

Importante:
Para obtener más información acerca del par de claves de nombre seguro, vea el apartado sobre informes de seguridad de nombres seguros y seguridad en .NET Framework en el centro de desarrollo de .NET de MSDN.

Para generar el ejemplo PolygonsCRI

Abra el archivo de proyecto PolygonsCRI.sln en Visual Studio 2005.
En el menú Generar, seleccione Generar solución.
Abra el archivo de proyecto PolygonsCRI.sln en Visual Studio.

Implementar el ejemplo

Para implementar el ejemplo PolygonsCRI

Edite el archivo rsreportserver.config para registrar el ejemplo PolygonsCRI:

Inserte las líneas siguientes antes de </Extensions>:

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

Edite el archivo rssrvpolicy.config para agregar un grupo de código correspondiente al elemento de informe personalizado:

Agregue las líneas siguientes:

<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>

Edite el archivo rsreportdesigner.config para registrar el componente de tiempo de ejecución, el componente de tiempo de diseño y el conversor de tipos de elemento:

Agregue las líneas siguientes antes de </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>

Copie el archivo PolygonsCRI.dll del directorio \PolygonCRI\Bin\Debug donde copió el proyecto de ejemplo en el directorio de ensamblados privados de Visual Studio (de forma predeterminada, \Archivos de programa\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies).
Copie el archivo PolygonsCRI.dll del directorio \PolygonCRI \Bin\Debug donde copió el proyecto de ejemplo en el directorio de archivos binarios de Microsoft SQL Server Reporting Services (de forma predeterminada, \Archivos de programa\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\Bin).
Copie el archivo PolygonsDesigner.dll del directorio \PolygonDesigner\Bin\Debug en el directorio de ensamblados privados de Visual Studio (de forma predeterminada, \Archivos de programa\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies).

Ejecutar el ejemplo

Esta sección contiene una visita guiada rápida que muestra cómo hacer referencia al elemento de informe personalizado Polygon en Visual Studio y cómo probarlo.

Para agregar PolygonDesigner al cuadro de herramientas de Visual Studio

Haga clic con el botón secundario en el cuadro de herramientas de Visual Studio.
Seleccione Elegir elementos.
Vaya a la carpeta \Archivos de programa\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies y seleccione PolygonsDesigner.dll.

Para ejecutar el ejemplo

Abra el proyecto de informe de ejemplo \PolygonsReport\Polygons.sln en Visual Studio.
Haga clic en la ficha Vista previa en el informe de ejemplo, o implemente el informe de ejemplo en el servidor y ejecútelo.

Para editar un informe con el control personalizado PolygonDesigner en Visual Studio, puede realizar las siguientes operaciones:

Establecer las propiedades del control polygons en el examinador de propiedades.
Editar las propiedades mediante el menú contextual del control.
Arrastrar los campos en las áreas para colocar del control desde la lista de campos.
Seleccionar el gráfico y, en el menú contextual, elegir Convertir en Polygons.

Vea también