Beispiel für benutzerdefiniertes Berichtselement

Artikel
12/15/2008

Neu: 05. Dezember 2005

Bei PolygonsCRI handelt es sich um ein Beispiel für ein einfaches benutzerdefiniertes Berichtselement. In diesem Beispiel werden mithilfe der System.Component-Klassen aus dem Microsoft .NET Framework und Klassen aus den Microsoft.ReportDesigner- und Microsoft.ReportingServices-Namespaces eine Laufzeitkomponente und eine Entwurfszeitkomponente eines benutzerdefinierten Berichtselements implementiert, die im Berichts-Generator verwendet werden können.

Die SQL Server-Beispiele werden während des Setups nicht automatisch installiert. Anweisungen zum Installieren der Beispiele finden Sie unter Installieren von Beispielen.

Wichtig:
Die Beispiele dienen nur zu Lernzwecken. Sie sind nicht für die Verwendung in einer Produktionsumgebung gedacht und wurden nicht in einer Produktionsumgebung getestet. Microsoft bietet für diese Beispiele keinen technischen Support. Beispielanwendungen und Assemblys sollten nicht ohne die Zustimmung des Systemadministrators mit der SQL Server-Produktionsdatenbank oder dem Berichtsserver verbunden sein oder verwendet werden.

Die Beispiele dienen nur zu Lernzwecken. Sie sind nicht für die Verwendung in einer Produktionsumgebung gedacht und wurden nicht in einer Produktionsumgebung getestet. Microsoft bietet für diese Beispiele keinen technischen Support. Beispielanwendungen und Assemblys sollten nicht ohne die Zustimmung des Systemadministrators mit der SQL Server-Produktionsdatenbank oder dem Berichtsserver verbunden sein oder verwendet werden.

Anforderungen

Damit Sie das PolygonsCRI-Beispiel verwenden können, sollten Sie mit Visual Studio und Microsoft Visual C# vertraut sein. Außerdem muss Ihr System die folgenden Anforderungen erfüllen:

Microsoft SQL Server 2005 mit Reporting Services
Microsoft SQL Server Business Intelligence Development Studio
Microsoft Visual Studio 2005
Microsoft .NET Framework, Version 2.0

Reporting Services-Beispiele. Ein Berichtsserver im Netzwerk, für den Sie eine Zugriffsberechtigung besitzen.

Hinweis:
Business Intelligence (BI) Development Studio und Visual Studio 2005 werden auf Itanium-basierten Computern nicht unterstützt. Auf x64-basierten Computern sind sie jedoch verfügbar. Wenn die SQL Server 2005-Beispieldatenbanken auf einem Itanium-basierten Computer bereitgestellt wurden, können Sie BI Development Studio oder Visual Studio sowohl auf einem x86- als auch x64-basierten Computer verwenden, um die Beispiele zu ändern und auszuführen.

Business Intelligence (BI) Development Studio und Visual Studio 2005 werden auf Itanium-basierten Computern nicht unterstützt. Auf x64-basierten Computern sind sie jedoch verfügbar. Wenn die SQL Server 2005-Beispieldatenbanken auf einem Itanium-basierten Computer bereitgestellt wurden, können Sie BI Development Studio oder Visual Studio sowohl auf einem x86- als auch x64-basierten Computer verwenden, um die Beispiele zu ändern und auszuführen.

Speicherort

Dieses Beispiel befindet sich im Unterverzeichnis \Extension Samples\CustomReportItem Sample des Verzeichnisses mit den Reporting Services-Beispielen.

Beispiel:

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

Erstellen des Beispiels

Generieren Sie die Schlüsseldatei mithilfe der folgenden Anweisungen, falls Sie noch keine Schlüsseldatei mit starkem Namen erstellt haben.

So generieren Sie eine Schlüsseldatei mit starkem Namen

Öffnen Sie eine Microsoft Visual Studio 2005-Eingabeaufforderung. Klicken Sie auf Start, zeigen Sie auf Alle Programme und danach auf Microsoft .NET Framework SDK 2.0, und klicken Sie anschließend auf SDK-Eingabeaufforderung.

– oder –

Öffnen Sie eine Microsoft .NET Framework-Eingabeaufforderung. Klicken Sie auf Start, zeigen Sie auf Alle Programme und dann auf Microsoft .NET Framework SDK 2.0, und klicken Sie anschließend auf SDK-Eingabeaufforderung.

Wechseln Sie an der Eingabeaufforderung mit dem Befehl CD (Verzeichnis wechseln) im Eingabeaufforderungsfenster vom aktuellen Verzeichnis zu dem Ordner, in dem die Beispiele installiert sind.

Hinweis:
Klicken Sie auf Start, zeigen Sie auf Alle Programme, Microsoft SQL Server und auf Dokumentation und Lernprogramme, und klicken Sie dann auf Beispielordner, um den Ordner zu ermitteln, in dem sich die Beispiele befinden. Wenn das Standardverzeichnis verwendet wurde, befinden sich die Beispiele im Verzeichnis <Systemlaufwerk>:\Programme\Microsoft SQL Server\100\Samples.

Führen Sie an der Eingabeaufforderung den folgenden Befehl zum Generieren der Schlüsseldatei aus:

sn -k SampleKey.snk

Wichtig:
Weitere Informationen zum Schlüsselpaar mit starkem Namen finden Sie unter "Security Briefs: Starke Namen und Sicherheit im .NET Framework" unter ".NET-Entwicklung" auf der MSDN-Website.

So erstellen Sie das PolygonsCRI-Beispiel

Öffnen Sie die Projektdatei PolygonsCRI.sln in Visual Studio 2005.
Klicken Sie im Menü Erstellen auf Projektmappe erstellen.
Öffnen Sie die Projektdatei PolygonsCRI.sln in Visual Studio.

Bereitstellen des Beispiels

So stellen Sie das PolygonsCRI-Beispiel bereit

Bearbeiten Sie die Datei rsreportserver.config für die Registrierung von PolygonsCRI:

Fügen Sie vor </Extensions> die folgenden Zeilen ein:

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

Bearbeiten Sie die Datei rssrvpolicy.config, und fügen Sie eine Codegruppe für das benutzerdefinierte Berichtselement hinzu:

Fügen Sie die folgenden Zeilen hinzu:

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

Bearbeiten Sie die Datei rsreportdesigner.config, um die Laufzeitkomponente, die Entwurfszeitkomponente und den Elementtypkonverter zu registrieren:

Fügen Sie vor </Extensions> die folgenden Zeilen hinzu:

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

Kopieren Sie die Datei PolygonsCRI.dll aus dem Verzeichnis \PolygonCRI\Bin\Debug, in das Sie das Beispielprojekt kopiert haben, in das Visual Studio-Verzeichnis für private Assemblys (standardmäßig ist dies das Verzeichnis \Programme\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies).
Kopieren Sie die Datei PolygonsCRI.dll aus dem Verzeichnis \PolygonCRI \Bin\Debug, in das Sie das Beispielprojekt kopiert haben, in das BIN-Verzeichnis von Microsoft SQL Server Reporting Services (standardmäßig ist dies das Verzeichnis \Programme\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\Bin).
Kopieren Sie die Datei PolygonsDesigner.dll aus dem Verzeichnis \PolygonDesigner\Bin\Debug in das Visual Studio-Verzeichnis für private Assemblys (standardmäßig ist dies das Verzeichnis \Programme\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies).

Ausführen des Beispiels

Dieser Abschnitt enthält eine kurze Anleitung dazu, wie Sie in Visual Studio auf das benutzerdefinierte Polygon-Berichtselement verweisen und es anschließend testen.

So fügen Sie PolygonDesigner zur Visual Studio-Toolbox hinzu

Klicken Sie mit der rechten Maustaste auf die Visual Studio-Toolbox.
Klicken Sie auf Elemente auswählen.
Navigieren Sie zum Ordner \Programme\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies, und wählen Sie die Datei PolygonsDesigner.dll aus.

So führen Sie das Beispiel aus

Öffnen Sie in Visual Studio das \PolygonsReport\Polygons.sln-Beispielberichtsprojekt.
Klicken Sie im Beispielbericht auf die Registerkarte Vorschau, oder stellen Sie den Beispielbericht auf dem Server bereit, und führen Sie den Bericht aus.

Zum Bearbeiten eines Berichts mithilfe des benutzerdefinierten PolygonDesigner-Steuerelements in Visual Studio stehen Ihnen die folgenden Möglichkeiten zur Verfügung:

Festlegen der Eigenschaften des Polygon-Steuerelements im Eigenschaftenbrowser.
Bearbeiten der Eigenschaften über das Kontextmenü des Steuerelements.
Ziehen von Feldern aus der Felderliste in die Ablegebereiche des Steuerelements.
Auswählen des Diagramms und Auswählen der Option zum Konvertieren in Polygone aus dem Kontextmenü.

Siehe auch

Freigeben über