Beispiel für eine Readme_Dateifreigabe-Datenverarbeitungserweiterung

Dieses Beispiel funktioniert nur mit SQL Server 2005 und SQL Server 2008. In einer SQL Server-Version vor SQL Server 2005 kann das Beispiel nicht ausgeführt werden.

FsiDataExtension ist eine einfache Datenverarbeitungserweiterung für das Windows-Dateisystem. Sie verwendet die Microsoft .NET Framework-Bibliotheksklassen System.IO.DirectoryInfo und System.IO.FileSystemInfo, um den Inhalt einer beliebigen gültigen Netzwerk-Dateifreigabe abzufragen. In diesem Beispiel werden die Schnittstellen der Datenverarbeitungserweiterung sowie andere .NET Framework-Klassen verwendet. Als Benennungskonvention wird das Präfix Fsi (File Share Information, Dateifreigabeinformationen) verwendet. Dieses Beispiel wird nicht auf Itanium-basierten Betriebssystemen unterstützt.

Anforderungen

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

• Microsoft Microsoft Visual Studio 2005 oder eine kompatible Entwicklungsumgebung (zum Anzeigen der Projektdateien).
• Microsoft SQL Server, einschließlich Reporting Services.
• Microsoft .NET Framework 2.0.
• Reporting Services-Beispiele. Sie können die Beispiele beim Ausführen des SQL Server-Setups installieren. In dieser Version wird durch die Installation der Beispiele ein separates Installationsprogramm auf Ihrem Computer installiert, mit dessen Hilfe Sie Beispiele extrahieren und installieren können. Sie können dieses Installationsprogramm über das Menü Start in der Programmgruppe Microsoft SQL Server ausführen.
• Ein Berichtsserver, für den Sie in Ihrem Netzwerk die Zugriffsberechtigung haben, falls Sie mit der Beispielerweiterung weitere Datenverarbeitungsfunktionen zu Ihrem Server hinzufügen möchten

Speicherort

Dieses Beispiel wird standardmäßig im folgenden Verzeichnis gespeichert:

C:\Programme\Microsoft SQL Server\100\Samples\Reporting Services\ Extension Samples\FindRenderSave Sample

Erstellen des Beispiels

Führen Sie zum Erstellen des Beispiels die folgenden Schritte aus.

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

1. Ö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 dann 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.

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

   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 <system_drive>:\Programme\Microsoft SQL Server\100\Samples.

3. 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 von MSDN.

So kompilieren Sie das Beispiel mit dem .NET Framework SDK

1. Kopieren Sie die Datei Microsoft.ReportingServices.Interfaces.dll vom Berichtsserververzeichnis \bin in Ihren Beispielordner.

2. Führen Sie die folgenden Befehle aus, um die Beispiel-Datenverarbeitungserweiterung Microsoft.Samples.ReportingServices.FsiDataExtension.dll zu erstellen.

   csc.exe /t:library /out:Microsoft.Samples.ReportingServices.FsiDataExtension.dll *.cs .\properties\*.cs /res:.\properties\Resources.resx  /r:Microsoft.ReportingServices.Interfaces.dll
   

So kompilieren Sie das Beispiel mit Visual Studio .NET

1. Öffnen Sie die FsiDataExtension-Projektmappendatei (FsiDataExtensionCS.sln oder FsiDataExtensionVB.sln) in Visual Studio 2005.

2. Wählen Sie im Projektmappen-Explorer das Projekt FsiDataExtension aus.

3. Klicken Sie im Menü Projekt auf Verweis hinzufügen.

4. Klicken Sie im Dialogfeld Verweis hinzufügen auf die Registerkarte .NET.

5. Klicken Sie auf Durchsuchen, und suchen Sie auf dem lokalen Laufwerk nach Microsoft.ReportingServices.Interfaces. Standardmäßig befindet sich die Assembly im Verzeichnis ReportServer\bin. Klicken Sie auf OK.

   Der ausgewählte Verweis wird dem Projekt hinzugefügt.

   Hinweis

   Der Verweis wurde dem Projekt möglicherweise bereits hinzugefügt. In diesem Fall muss ein Verweis nicht erneut hinzugefügt werden.

6. Klicken Sie im Menü Erstellen auf Projektmappe erstellen.

Bereitstellen des Beispiels

Nachdem Sie die vorherigen Schritte abgeschlossen haben, kann Microsoft.Samples.ReportingServices.FsiDataExtension.dll auf einem Berichtsserver oder für den Berichts-Designer zum Ausführen von Berichten für eine benutzerdefinierte Datenquelle bereitgestellt werden.

So stellen Sie das Beispiel bereit

1. Kopieren Sie Microsoft.Samples.ReportingServices.FsiDataExtension.dll auf den Berichtsserver. Standardmäßig werden Berichtsservererweiterungen im Verzeichnis C:\Program Files\Microsoft SQL Server\MSRS10.MSSQLSERVER\Reporting Services\ReportServer\bin gespeichert.

2. Kopieren Sie die Assembly in den Berichts-Designer. Standardmäßig werden Erweiterungen für den Berichts-Designer im Verzeichnis C:\Programme\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies gespeichert.

3. Fügen Sie folgenden Eintrag den Dateien RSReportServer.config und RSReportDesigner.config unter dem Element Data (der Standardspeicherort für die Datei RSReportDesigner.config ist C:\Programme\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies, und der Standardspeicherort für die Datei RSReportServer.config ist C:\Programme\Microsoft SQL Server\MSRS10.MSSQLSERVER\Reporting Services\ReportServer) hinzu:

   <Extension Name="FSI" Type="Microsoft.Samples.ReportingServices.FsiDataExtension.FsiConnection,Microsoft.Samples.ReportingServices.FsiDataExtension"/>
   

4. Um den Designer für generische Abfragen für die Beispiel-Datenverarbeitungserweiterung zu aktivieren, fügen Sie unter Designer den folgenden Eintrag zur Datei RSReportDesigner.config hinzu.

   <Extension Name="FSI" Type="Microsoft.ReportingServices.QueryDesigners.VDTQueryDesigner,Microsoft.ReportingServices.QueryDesigners"/>
   

Weitere Informationen zum Bereitstellen von Datenverarbeitungserweiterungen finden Sie unter Bereitstellen von Datenverarbeitungserweiterungen.

So konfigurieren Sie die Codezugriffssicherheit für das Beispiel

1. Öffnen Sie die Richtlinienkonfigurationsdatei für den Berichtsserver (rssrvpolicy.config). Standardmäßig wird die Datei im Verzeichnis C:\Programme\Microsoft SQL Server\MSRS10.MSSQLSERVER\Reporting Services\ReportServer gespeichert.

2. Den Datenverarbeitungserweiterungen muss volle Vertrauenswürdigkeit erteilt werden. Fügen Sie hierzu am Ende des Codegruppenabschnitts in der Konfigurationsdatei die folgenden Codegruppeninformationen hinzu:

   <CodeGroup class="UnionCodeGroup"
      version="1"
      PermissionSetName="FullTrust"
      Name="FSICodeGroup"
      Description="Code group for my FSI data processing extension">
         <IMembershipCondition class="UrlMembershipCondition"
            version="1"
            Url="C:\Program Files\Microsoft SQL Server\MSRS10.MSSQLSERVER\Reporting Services\ReportServer\bin\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
          />
   </CodeGroup>
   

3. Wenn Sie die Beispiel-Datenverarbeitungserweiterung im Berichts-Designer verwenden, wiederholen Sie die Schritte 1 und 2 mit der Richtlinienkonfigurationsdatei für die Vorschau im Berichts-Designer (rspreviewpolicy.config) und der folgenden Codegruppe:

   <CodeGroup class="UnionCodeGroup"
      version="1"
      PermissionSetName="FullTrust"
      Name="FSICodeGroup"
      Description="Code group for my FSI data processing extension">
         <IMembershipCondition class="UrlMembershipCondition"
            version="1"
            Url="C:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
          />
   </CodeGroup>
   

   Standardmäßig wird die Datei rspreviewpolicy.config im Verzeichnis C:\Programme\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies gespeichert.

   Weitere Informationen über Sicherheit .NET Framework und Reporting Services finden Sie unter Sichere Entwicklung (Reporting Services).

Erstellen eines Berichts, der FsiDataExtension verwendet

Dieser Abschnitt enthält kurze exemplarische Vorgehensweisen für das Erstellen eines Beispielberichts, der die Beispieldatenerweiterung verwendet.

So erstellen Sie das Berichtsprojekt

1. Klicken Sie auf Start, zeigen Sie auf Programme, zeigen Sie auf Microsoft SQL Server 2008, und klicken Sie dann auf Business Intelligence Development Studio.

2. Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.

3. Klicken Sie in der Liste Projekttypen auf Business Intelligence-Projekte.

4. Klicken Sie in der Liste Vorlagen auf Berichtsserverprojekt.

5. Geben Sie FsiReportProject in das Feld Name ein.

6. Klicken Sie auf OK, um das Berichtsprojekt zu erstellen.

So erstellen Sie den Bericht

1. Klicken Sie im Menü Projekt auf Neues Element hinzufügen.

2. Klicken Sie in der Liste Kategorien auf Berichtsprojekt.

3. Klicken Sie in der Liste Vorlagen auf Bericht.

4. Geben Sie FsiReport in das Feld Name ein, und klicken Sie dann auf Öffnen.

So fügen Sie eine Datenquelle hinzu, die die Beispieldatenerweiterung verwendet

1. Klicken Sie im Bereich Daten auf Neu, und wählen Sie dann Neues Dataset aus.

2. Geben Sie auf der Registerkarte Abfrage in das Textfeld Name die Zeichenfolge FsiDataSource ein.

3. Wählen Sie in der Liste Typ die Option Dateifreigabeinformationen aus.

4. Lassen Sie ConnectionString leer. Die Beispieldatenerweiterung verwendet keine Verbindungszeichenfolge.

5. Klicken Sie auf der Registerkarte Anmeldeinformationen auf einen der Serveranmeldetypen. Sie können den Benutzernamen und das Kennwort für die Dateifreigabe eingeben, auf die die Beispieldatenerweiterung zugreifen wird. Klicken Sie auf Windows-Authentifizierung verwenden (Integrierte Sicherheit), klicken Sie auf Verwenden Sie einen bestimmten Benutzernamen und ein bestimmtes Kennwort, und geben Sie Anmeldeinformationen ein, oder klicken Sie auf Anmeldeinformationen anfordern, und geben Sie eine Eingabeaufforderungs-Zeichenfolge ein.

   Sicherheitshinweis:
   Verwenden Sie nach Möglichkeit die Windows-Authentifizierung. Sie werden bei jedem Zugriff auf eine Netzwerkdateifreigabe zur Eingabe von Netzwerkanmeldeinformationen aufgefordert, es sei denn, Ihre Anmeldeinformationen wurden zwischengespeichert.

6. Klicken Sie auf OK, um die Datenquelle zu speichern.

So zeigen Sie das Dataset an

1. In der Datenansicht wird der Designer für generische Abfragen angezeigt. Wählen Sie in Befehlstyp die Option Text aus.

2. Geben Sie im Abfragebereich direkt unter der Symbolleiste des Designers für generische Abfragen den Pfad zu einer Netzwerk-Dateifreigabe ein, die in Ihrem Netzwerk verfügbar ist. Geben Sie z. B. \\Computer1\Public ein.

3. Klicken Sie auf der Symbolleiste des Designers für generische Abfragen auf die Schaltfläche Ausführen (!).

   Die Dateifreigabe wird im Detailbereich angezeigt.

So entwerfen Sie das Berichtslayout

1. Klicken Sie in der Entwurfsansicht in der Toolbox auf Tabelle.

2. Ziehen Sie das Steuerelement Tabelle auf die Entwurfsoberfläche.

3. Ziehen Sie im Bereich Berichtsdaten das Feld Name in die erste Zelle in der Zeile Detail. Fügen Sie der Tabelle bei Bedarf Felder hinzu.

So zeigen Sie eine Vorschau des Berichts an

1. Klicken Sie auf die Registerkarte Vorschau, um eine Vorschau des Berichts anzuzeigen. Je nach Ihren Einstellungen für die Anmeldeinformationen für FsiDataSource müssen Sie möglicherweise einen Benutzernamen und ein Kennwort eingeben.

Siehe auch

Tasks

Kompilieren und Ausführen von Codebeispielen
Reporting Services-Beispiele

Andere Ressourcen

Erweiterungsbeispiele (Reporting Services)
Implementieren von Datenverarbeitungserweiterungen

Hilfe und Informationen

Informationsquellen für SQL Server 2008