Esempio CustomReportItem

Articolo
12/15/2008

Data creazione: 5 dicembre 2005

PolygonsCRI è un esempio di report personalizzato semplice in cui vengono utilizzate le classi System.Component di Microsoft .NET Framework e le classi degli spazi dei nomi Microsoft.ReportDesigner e Microsoft.ReportingServices per implementare un componente di run-time e un componente della modalità di progettazione di un report personalizzato utilizzabili in Generatore report.

Gli esempi di SQL Server non vengono installati automaticamente durante l'installazione. Per informazioni sulle procedure di installazione degli esempi, vedere Installazione degli esempi.

Importante:
Gli esempi vengono offerti esclusivamente a scopo didattico. Non sono progettati per l'utilizzo in un ambiente di produzione e non sono stati testati in un ambiente di produzione. Microsoft non fornisce servizi di supporto tecnico per questi esempi. Le applicazioni e gli assembly di esempio non devono essere connessi o utilizzati con il database di SQL Server o il server di report in un ambiente di produzione senza l'autorizzazione dell'amministratore di sistema.

Gli esempi vengono offerti esclusivamente a scopo didattico. Non sono progettati per l'utilizzo in un ambiente di produzione e non sono stati testati in un ambiente di produzione. Microsoft non fornisce servizi di supporto tecnico per questi esempi. Le applicazioni e gli assembly di esempio non devono essere connessi o utilizzati con il database di SQL Server o il server di report in un ambiente di produzione senza l'autorizzazione dell'amministratore di sistema.

Requisiti

Per utilizzare l'esempio PolygonsCRI, è necessario avere familiarità con Visual Studio e Microsoft Visual C#. Il sistema deve inoltre soddisfare i requisiti seguenti:

Microsoft SQL Server 2005 con Reporting Services.
Microsoft SQL Server Business Intelligence Development Studio.
Microsoft Visual Studio 2005.
Microsoft .NET Framework versione 2.0.
Esempi di Reporting Services. Un server di report in rete per cui si disponga di autorizzazioni di accesso.

[!NOTA] Business Intelligence (BI) Development Studio e Visual Studio 2005 non sono supportati nei computer con processore Itanium. È invece possibile utilizzare questi prodotti in computer con processore x64. Se i database di esempio di SQL Server 2005 sono stati distribuiti in un computer con processore Itanium, utilizzare BI Development Studio o Visual Studio in computer con processore x86 o x64 per modificare ed eseguire gli esempi.

Percorso

L'esempio è disponibile nella sottodirectory \Extension Samples\CustomReportItem Sample della directory degli esempi di Reporting Services.

Ad esempio:

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

Generazione dell'esempio

Se non è stato ancora creato un file di chiave con nome sicuro, generare il file di chiave seguendo le istruzioni seguenti.

Per generare un file di chiave con nome sicuro

Aprire il prompt dei comandi di Microsoft Visual Studio 2005. Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft .NET Framework SDK 2.0, quindi SDK Command Prompt.

-- oppure --

Aprire il prompt dei comandi di Microsoft .NET Framework. Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft .NET Framework SDK 2.0, quindi SDK Command Prompt.
Utilizzare il comando CD (change directory) per passare dalla directory corrente della finestra del prompt dei comandi alla cartella in cui sono stati installati gli esempi.

[!NOTA] Per determinare la cartella in cui si trovano gli esempi, fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft SQL Server 2005, Documentazione ed esercitazioni, quindi Samples. Se è stato utilizzato il percorso di installazione predefinito, gli esempi si troveranno in <unità_sistema>:\Programmi\Microsoft SQL Server\100\Samples.

Al prompt dei comandi digitare il comando seguente per generare il file di chiave:

sn -k SampleKey.snk

Importante:
Per ulteriori informazioni sulla coppia di chiavi con nome sicuro, vedere l'argomento relativo ai nomi sicuri e alla protezione in .NET Framework nel centro per sviluppatori di .NET su MSDN.

Per generare l'esempio PolygonsCRI

Aprire il file di progetto PolygonsCRI.sln in Visual Studio 2005.
Scegliere Genera soluzione dal menu Genera
Aprire il file di progetto PolygonsCRI.sln in Visual Studio.

Distribuzione dell'esempio

Per distribuire l'esempio PolygonsCRI

Modificare rsreportserver.config per registrare PolygonsCRI:

Inserire le righe seguenti prima di </Extensions>:

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

Modificare il file rssrvpolicy.config per aggiungere un gruppo di codice per il report personalizzato:

Aggiungere le righe seguenti:

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

Modificare il file rsreportdesigner.config per registrare il componente di run-time, il componente della fase di progettazione e il convertitore del tipo di elemento:

Aggiungere le righe seguenti prima di </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>

Copiare il file PolygonsCRI.dll dalla directory \PolygonCRI\Bin\Debug in cui è stato copiato il progetto di esempio nella directory degli assembly privati di Visual Studio (per impostazione predefinita \Programmi\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies).
Copiare il file PolygonsCRI.dll dalla directory \PolygonCRI \Bin\Debug in cui è stato copiato il progetto di esempio nella directory bin di Microsoft SQL Server Reporting Services (per impostazione predefinita \Programmi\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\Bin).
Copiare il file PolygonsDesigner.dll dalla directory \PolygonDesigner\Bin\Debug nella directory degli assembly privati di Visual Studio (per impostazione predefinita \Programmi\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies).

Esecuzione dell'esempio

In questa sezione è contenuto uno scenario che illustra brevemente come fare riferimento al report personalizzato Polygon in Visual Studio e come testarlo.

Per aggiungere PolygonDesigner alla casella degli strumenti di Visual Studio

Fare clic con il pulsante destro del mouse sulla casella degli strumenti di Visual Studio.
Scegliere Scegli elementi.
Passare alla cartella \Programmi\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies e selezionare PolygonsDesigner.dll.

Per eseguire l'esempio

Aprire il progetto del report di esempio \PolygonsReport\Polygons.sln in Visual Studio.
Fare clic sulla scheda Anteprima nel report di esempio o distribuire il report di esempio nel server ed eseguirlo.

Per modificare un report tramite il controllo personalizzato PolygonDesigner in Visual Studio, è possibile eseguire una delle operazioni seguenti:

Impostare le proprietà del controllo nel Visualizzatore proprietà.
Modificare le proprietà tramite il menu di scelta rapida del controllo.
Trascinare campi dal relativo elenco nelle aree di rilascio del controllo.
Selezionare il grafico e scegliere Convert to Polygons dal menu di scelta rapida.

Vedere anche

Condividi tramite