Exemple Custom Report Item (CRI)

Article
12/15/2008

Nouveau : 5 décembre 2005

PolygonsCRI est un exemple simple d'élément de rapport personnalisé. Il utilise les classes System.Component de Microsoft .NET Framework et les classes des espaces de noms Microsoft.ReportDesigner et Microsoft.ReportingServices pour mettre en œuvre un composant d'exécution et un composant de conception pouvant être utilisés dans le Générateur de rapports.

Les exemples SQL Server ne sont pas installés automatiquement lors de l'installation. Pour obtenir des instructions sur l'installation des exemples, consultez Installation des exemples.

Important :
Les exemples sont fournis à titre éducatif uniquement. Ils ne sont pas destinés à être utilisés dans un environnement de production et n'ont pas été testés à cet usage. Microsoft n'assure pas de support technique pour ces exemples. Les exemples d'applications et les assemblys ne doivent pas être utilisés avec votre base de données SQL Server de production ou votre serveur de rapports, ou y être connectés, sans l'autorisation de l'administrateur système.

Les exemples sont fournis à titre éducatif uniquement. Ils ne sont pas destinés à être utilisés dans un environnement de production et n'ont pas été testés à cet usage. Microsoft n'assure pas de support technique pour ces exemples. Les exemples d'applications et les assemblys ne doivent pas être utilisés avec votre base de données SQL Server de production ou votre serveur de rapports, ou y être connectés, sans l'autorisation de l'administrateur système.

Configuration requise

Pour utiliser l'exemple PolygonsCRI, vous devez maîtriser Visual Studio et le langage de programmation Microsoft Visual C#. En outre, votre système doit présenter la configuration suivante :

Microsoft SQL Server 2005 avec Reporting Services.
Microsoft SQL Server Business Intelligence Development Studio.
Microsoft Visual Studio 2005.
Microsoft .NET Framework version 2.0.

Exemples Reporting Services. Un serveur de rapports auquel vous êtes autorisé à accéder sur votre réseau.

Remarque :
Les ordinateurs Itanium ne prennent pas en charge Business Intelligence (BI) Development Studio et Visual Studio 2005. Une prise en charge est en revanche possible sur des ordinateurs x64. Si vous avez déployé les exemples de bases de données SQL Server 2005 sur un ordinateur Itanium, utilisez Business Intelligence Development Studio ou Visual Studio sur un ordinateur x86 ou x64 pour les modifier et les exécuter.

Les ordinateurs Itanium ne prennent pas en charge Business Intelligence (BI) Development Studio et Visual Studio 2005. Une prise en charge est en revanche possible sur des ordinateurs x64. Si vous avez déployé les exemples de bases de données SQL Server 2005 sur un ordinateur Itanium, utilisez Business Intelligence Development Studio ou Visual Studio sur un ordinateur x86 ou x64 pour les modifier et les exécuter.

Emplacement

Cet exemple se trouve dans le sous-répertoire \Extension Samples\CustomReportItem Sample du répertoire d'exemples de Reporting Services.

Par exemple :

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

Génération de l'exemple

Si vous n'avez pas encore créé un fichier de clé de nom fort, utilisez la procédure suivante pour générer ce fichier.

Pour générer un fichier de clé de nom fort

Ouvrez une invite de commandes Microsoft Visual Studio 2005. Cliquez sur Démarrer, pointez sur Tous les programmes et sur Kit de développement Microsoft .NET Framework SDK 2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

-- Ou --

Ouvrez une invite de commandes Microsoft .NET Framework. Cliquez sur Démarrer, pointez sur Tous les programmes et sur Kit de développement Microsoft .NET Framework SDK 2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

Utilisez la commande CD (changer de répertoire) pour remplacer le dossier actif dans la fenêtre de l'invite de commandes par le dossier dans lequel les exemples sont installés.

Remarque :
Pour déterminer le dossier dans lequel se trouvent les exemples, cliquez sur le bouton Démarrer, pointez successivement sur Tous les programmes, sur Microsoft SQL Server 2005 et sur Documentation et didacticiels, puis cliquez sur le répertoire Samples. Si l'emplacement d'installation par défaut a été utilisé, les exemples se trouvent dans <lecteur_système>:\Program Files\Microsoft SQL Server\100\Samples.

Pour déterminer le dossier dans lequel se trouvent les exemples, cliquez sur le bouton Démarrer, pointez successivement sur Tous les programmes, sur Microsoft SQL Server 2005 et sur Documentation et didacticiels, puis cliquez sur le répertoire Samples. Si l'emplacement d'installation par défaut a été utilisé, les exemples se trouvent dans <lecteur_système>:\Program Files\Microsoft SQL Server\100\Samples.

À l'invite de commandes, exécutez la commande suivante pour générer le fichier de clé :

sn -k SampleKey.snk

Important :
Pour plus d'informations sur la paire de clés de nom fort, consultez l'article de sécurité concernant les noms forts et la sécurité dans .NET Framework, dans le Centre de développement .NET sur MSDN.

Pour générer l'exemple PolygonsCRI

Ouvrez le fichier de projet PolygonsCRI.sln dans Visual Studio 2005.
Dans le menu Générer, sélectionnez Générer la solution.
Ouvrez le fichier de projet PolygonsCRI.sln dans Visual Studio.

Déploiement de l'exemple

Pour déployer l'exemple PolygonsCRI

Modifiez le fichier rsreportserver.config pour inscrire l'exemple PolygonsCRI :

Insérez les lignes suivantes avant </Extensions> :

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

Modifiez le fichier rssrvpolicy.config pour ajouter un groupe de codes pour l'élément de rapport personnalisé :

Ajoutez les lignes suivantes :

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

Modifiez le fichier rsreportdesigner.config pour inscrire le composant d'exécution, le composant de conception et le convertisseur de type d'élément.

Ajoutez les lignes suivantes avant </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>

Copiez le fichier PolygonsCRI.dll à partir du répertoire \PolygonCRI\Bin\Debug où vous avez copié l'exemple de projet dans le répertoire d'assemblys privés Visual Studio (par défaut, \Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies).
Copiez le fichier PolygonsCRI.dll à partir du répertoire \PolygonCRI\Bin\Debug où vous avez copié l'exemple de projet dans le répertoire bin de Microsoft SQL Server Reporting Services (par défaut, \Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\Bin).
Copiez le fichier PolygonsDesigner.dll à partir du répertoire \PolygonDesigner\Bin\Debug dans le répertoire d'assemblys privés Visual Studio (par défaut, \Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies).

Exécution de l'exemple

Cette section contient une procédure pas à pas expliquant rapidement comment générer une référence à l'élément de rapport personnalisé Polygon dans Visual Studio pour le tester.

Pour ajouter PolygonDesigner à la boîte à outils Visual Studio

Cliquez avec le bouton droit dans la boîte à outils Visual Studio.
Sélectionnez Choisir les éléments.
Naviguez jusqu'au dossier \Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies et sélectionnez PolygonsDesigner.dll.

Pour exécuter l'exemple

Ouvrez l'exemple de projet de rapport \PolygonsReport\Polygons.sln dans Visual Studio.
Cliquez sur l'onglet Aperçu dans l'exemple de rapport ou déployez ce dernier sur le serveur pour l'exécuter.

Pour modifier un rapport à l'aide du contrôle personnalisé PolygonDesigner dans Visual Studio, vous pouvez :

définir les propriétés du contrôle de polygones dans le navigateur de propriétés ;
modifier les propriétés via le menu contextuel du contrôle ;
faire glisser des champs dans les zones de dépôt du contrôle à partir de la liste des champs ;
sélectionner le graphique et dans le menu contextuel choisir Convertir en polygones.

Voir aussi