Registrieren eines .NET Framework-Standarddatenproviders (SSRS)Register a Standard .NET Framework Data Provider (SSRS)

Wenn Sie zum Abrufen von Daten für ein .NET Framework.NET Framework -Berichtsdataset einen Reporting ServicesReporting Services -Datenanbieter eines Drittanbieters verwenden möchten, müssen Sie die .NET Framework.NET Framework -Datenanbieterassembly an zwei Speicherorten bereitstellen und registrieren: auf dem Berichterstellungsclient und auf dem Berichtsserver.To use a third-party .NET Framework.NET Framework data provider to retrieve data for a Reporting ServicesReporting Services report dataset, you need to deploy and register the .NET Framework.NET Framework data provider assembly in two locations: on the report authoring client and on the report server. Auf dem Berichterstellungsclient müssen Sie den Datenanbieter als Datenquellentyp registrieren und einem Abfrage-Designer zuordnen.On the report authoring client, you must register the data provider as a data source type and associate it with a query designer. Beim Erstellen eines Berichtsdatasets können Sie diesen Datenanbieter als Datenquellentyp auswählen.You can then select this data provider as a type of data source when you create a report dataset. Der zugeordnete Abfrage-Designer wird geöffnet, um das Erstellen von Abfragen für diesen Datenquellentyp zu erleichtern.The associated query designer opens to help you create queries for this data source type. Der Datenanbieter muss auf dem Berichtsserver als Datenquellentyp registriert werden.On the report server, you must register the data provider as a data source type. Anschließend können Sie veröffentlichte Berichte verarbeiten, für die mithilfe dieses Datenanbieters Daten von einer Datenquelle abgerufen werden.You can then process published reports that retrieve data from a data source using this data provider.

Es wird nicht notwendigerweise die gesamte Funktionalität von Drittanbieter-Datenanbietern unterstützt, die mit den Datenverarbeitungserweiterungen von Reporting ServicesReporting Services verfügbar ist.Third-party data providers do not necessarily provide all the functionality available with the Reporting ServicesReporting Services data processing extensions. Weitere Informationen finden Sie unter Von Reporting Services unterstützte Datenquellen (SSRS).For more information, see Data Sources Supported by Reporting Services (SSRS). Informationen zum Erweitern der Funktionalität eines . .NET Framework.NET FrameworkTo learn about extending the functionality of a . .NET Framework.NET Framework Datenanbieter, siehe Implementieren von Datenverarbeitungserweiterungen.data provider, see Implementing a Data Processing Extension.

Zum Installieren und Registrieren von Datenanbietern benötigen Sie Anmeldeinformationen als Administrator.You need administrator credentials to install and register data providers.

Registrieren eines .NET Framework-Datenanbieters auf dem BerichtsserverRegistering a .NET Framework Data Provider on the Report Server

Wenn Sie auf dem Berichtsserver veröffentlichte Berichte verarbeiten möchten, für die dieser .NET Framework.NET Framework -Datenanbieter verwendet wird, muss die Assembly auf dem Berichtsserver installiert werden.In order to process published reports that use this .NET Framework.NET Framework data provider on the report server, you need to install the assembly on the report server. Zwei Konfigurationsdateien müssen geändert werden.You must modify two configuration files. Ändern Sie rsreportserver.config so, dass der Datenanbieter registriert wird.Modify rsreportserver.config to register the data provider. Ändern Sie rssrvpolicy.config so, dass Codezugriffsberechtigungen für die Assembly erteilt werden.Modify rssrvpolicy.config to grant code access security permissions for the assembly.

So installieren Sie eine Datenanbieterassembly auf dem BerichtsserverTo install a data provider assembly on the report server

  1. Navigieren Sie zum Standardspeicherort des BIN-Verzeichnisses auf dem Berichtsserver, auf dem Sie den .NET Framework.NET Framework -Datenanbieter verwenden möchten.Navigate to the default location of the bin directory on the report server on which you want to use the .NET Framework.NET Framework data provider. Der Standardspeicherort des Bin-Verzeichnis des Berichtsservers ist <Laufwerk >: "\Programme\Microsoft SQL Server\MSRS10_50.MSSQLSERVER\Reporting Services\ReportServer\bin".The default location of the report server bin directory is <drive>:\Program Files\Microsoft SQL Server\MSRS10_50.MSSQLSERVER\Reporting Services\ReportServer\bin.

  2. Kopieren Sie die Assembly aus dem Bereitstellungsverzeichnis in das BIN-Verzeichnis des Berichtsservers.Copy your assembly from your staging location to the bin directory of the report server. Sie können die Assembly im globalen Assemblycache (Global Assembly Cache, GAC) laden.Alternatively, you can load your assembly in the global assembly cache (GAC). Weitere Informationen finden Sie unter dem Thema Arbeiten mit Assemblys und dem globalen Assemblycache in der .NET Framework.NET Framework SDK-Dokumentation zur Plattform MSDN.For more information, see Working with Assemblies and the Global Assembly Cache in the .NET Framework.NET Framework SDK documentation on MSDN.

So registrieren Sie einen .NET-Datenanbieter auf dem BerichtsserverTo register a .NET data provider on the report server

  1. Erstellen Sie in dem ReportServer-Verzeichnis, das dem BIN-Verzeichnis übergeordnet ist, eine Sicherungskopie der Datei RSReportServer.config.Make a backup of the RSReportServer.config file in the ReportServer parent directory for bin.

  2. Öffnen Sie die Datei "RSReportServer.config".Open RSReportServer.config. Sie können die Konfigurationsdatei mit Visual StudioVisual Studio oder in einem einfachen Text-Editor wie Editor öffnen.You can open the configuration file with Visual StudioVisual Studio or a simple text editor, such as Notepad.

  3. Suchen Sie das Data -Element in der Datei RSReportServer.config.Locate the Data element in the RSReportServer.config file. Im folgenden Verzeichnis muss ein Eintrag für den .NET Framework.NET Framework -Datenanbieter erstellt werden:An entry for the .NET Framework.NET Framework data provider should be made in the following location:

    <Extensions>  
       <Data>  
          <Extension Your data provider configuration information goes here />  
       </Data>  
    </Extensions>  
    
  4. Fügen Sie einen Eintrag für den .NET Framework.NET Framework -Datenanbieter hinzu.Add an entry for the .NET Framework.NET Framework data provider.

    AttributAttribute DescriptionDescription
    NameName Geben Sie einen eindeutigen Namen für den Datenanbieter an, z. B. MyNETDataProvider.Provide a unique name for the data provider, for example, MyNETDataProvider. Die maximale Länge für das Name -Attribut beträgt 255 Zeichen.The maximum length for the Name attribute is 255 characters. Der Name muss für sämtliche Einträge im Extension -Element einer Konfigurationsdatei eindeutig sein.The name must be unique among all entries within the Extension element of a configuration file. Der hier eingeschlossene Wert wird beim Erstellen einer neuen Datenquelle in der Dropdownliste der Datenquellentypen angezeigt.The value you include here appears in the drop-down list of data source types when you create a new data source.
    TypType Geben Sie eine durch Trennzeichen getrennte Liste, die den vollqualifizierten Namespace der Klasse enthält, implementiert die IDbConnection -Schnittstelle, gefolgt vom Namen des der .NET Framework.NET Framework -datenanbieterassembly (nicht einschließlich der Erweiterung ".dll-Datei namens").Enter a comma-separated list that includes the fully qualified namespace of the class that implements the IDbConnection interface, followed by the name of the .NET Framework.NET Framework data provider assembly (not including the .dll file name extension).

    Für eine im BIN-Verzeichnis des Berichtsservers bereitgestellte DLL-Datei kann der Eintrag beispielsweise dem Folgenden ähneln:For example, the entry might resemble the following for a DLL deployed to the report server bin directory:

    <Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly" />   
    

    Wenn Sie die Assembly in den GAC (Global Assembly Cache, globalen Assemblycache) laden, müssen Sie die Eigenschaften für starke Namen bereitstellen.If you load your assembly into the global assembly cache (GAC), you must provide the strong name properties. Beispiel:For example:

    <Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly,Version=1.0.0.0, Culture=neutral, PublicKeyToken=MyPublicToken"/>  
    

Festlegen der Codegruppenrichtlinie für einen .NET-DatenanbieterTo set the code group policy for a .NET data provider

  1. Erstellen Sie im Verzeichnis "ReportServer", das dem Verzeichnis "bin" übergeordnet ist, eine Sicherungskopie der Datei "rssrvpolicy.config".Make a backup copy of the rssrvpolicy.config file in the ReportServer parent directory for bin.

  2. Öffnen Sie die Datei "rssrvpolicy.config".Open rssrvpolicy.config. Sie können die Konfigurationsdatei mit Visual StudioVisual Studio oder in einem einfachen Text-Editor wie Editor öffnen.You can open the configuration file with Visual StudioVisual Studio or a simple text editor such as Notepad.

  3. Suchen Sie das CodeGroup -Element in der Datei rssrvpolicy.config.Locate the CodeGroup element in the rssrvpolicy.config file.

  4. Fügen Sie eine Codegruppe für die Datenanbieterassembly hinzu, durch die die Berechtigung FullTrust erteilt wird.Add a code group for the data provider assembly that grants FullTrust permission. Die Codegruppe könnte beispielsweise der Folgenden ähneln:Your code group might resemble the following:

    <CodeGroup class="UnionCodeGroup"  
       version="1"  
       PermissionSetName="FullTrust"  
       Name="ThisDataProviderCodeGroup"  
       Description="Code group for the .NET data provider">  
          <IMembershipCondition class="UrlMembershipCondition"  
             version="1"  
             Url=  
    "C:\Program Files\Microsoft SQL Server\MSRS10_50.MSSQLSERVER\Reporting Services\ReportServer\bin\DataProviderAssembly.dll"  
           />  
    </CodeGroup>  
    

    Die URL-Mitgliedschaft ist eine der vielen Mitgliedschaftsbedingungen, die Sie für den Datenanbieter auswählen können.URL membership is only one of many membership conditions you might select for the data provider.

Überprüfen der Bereitstellung und der RegistrierungVerifying the Deployment and Registration

Sie können überprüfen, ob der Datenanbieter erfolgreich auf dem Berichtsserver bereitgestellt wurde, indem Sie den Berichts-Manager öffnen und sicherstellen, dass der Datenanbieter in der Liste verfügbarer Datenquellen vorhanden ist.You can verify whether the data provider was deployed successfully to the report server by opening Report Manager and verifying that the data provider is included in the list of available data sources. Weitere Informationen zu Berichts-Manager und Datenquellen finden Sie unter Erstellen, Ändern und Löschen von freigegebenen Datenquellen (SSRS).For more information about Report Manager and data sources, see Create, Modify, and Delete Shared Data Sources (SSRS).

Registrieren eines .NET Framework-Datenanbieters auf dem Berichts-Designer-ClientRegistering a .NET Framework Data Provider on the Report Designer Client

Wenn Sie Berichte erstellen möchten, für die dieser .NET Framework.NET Framework -Datenanbieter als Datenquelle verwendet wird, muss die Assembly auf dem Clientcomputer installiert werden, auf dem der Berichts-Designer ausgeführt wird.In order to author reports that use this .NET Framework.NET Framework data provider for a data source, you must install the assembly on your client computer that runs Report Designer. Zwei Konfigurationsdateien müssen geändert werden.You must modify two configuration files. Ändern Sie RSReportDesigner.config so, dass der Datenanbieter als Datenquelle registriert und der standardmäßige Abfrage-Designer verwendet wird.Modify RSReportDesigner.config to register the data provider as a data source and to use the generic query designer. Ändern Sie RSPreviewPolicy.config so, dass Codezugriffsberechtigungen für die Datenanbieterassembly erteilt werden.Modify RSPreviewPolicy.config to grant code access security permissions for the data provider assembly.

So installieren Sie eine Datenanbieterassembly auf dem Berichts-Designer-ClientTo install a data provider assembly on the Report Designer client

  1. Navigieren Sie zum Standardspeicherort des Verzeichnisses PrivateAssemblies auf dem Berichts-Designer-Client, auf dem Sie den .NET Framework.NET Framework -Datenanbieter verwenden möchten.Navigate to the default location of the PrivateAssemblies directory on the Report Designer client on which you want to use the .NET Framework.NET Framework data provider. Der Standardspeicherort des Verzeichnisses privateassemblies ist <Laufwerk >: \Programme\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies.The default location of the PrivateAssemblies directory is <drive>:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies.

  2. Kopieren Sie die Assembly aus dem Bereitstellungsverzeichnis in das Verzeichnis PrivateAssemblies des Berichts-Designer-Clients.Copy your assembly from your staging location to the PrivateAssemblies directory of the Report Designer client. Sie können die Assembly im globalen Assemblycache (Global Assembly Cache, GAC) laden.Alternatively, you can load your assembly in the global assembly cache (GAC). Weitere Informationen finden Sie unter dem Thema Arbeiten mit Assemblys und dem globalen Assemblycache in der .NET Framework.NET Framework SDK-Dokumentation zur Plattform MSDN.For more information, see Working with Assemblies and the Global Assembly Cache in the .NET Framework.NET Framework SDK documentation on MSDN.

So registrieren Sie einen .NET-Datenanbieter auf dem Berichts-Designer-ClientTo register a .NET data provider on the Report Designer client

  1. Erstellen Sie eine Sicherungskopie der Datei "RSReportDesigner.config" im Verzeichnis "PrivateAssemblies".Make a backup copy of the RSReportDesigner.config file in the PrivateAssemblies directory.

  2. Öffnen Sie die Datei "RSReportDesigner.config" mit Visual StudioVisual Studio oder in einem einfachen Text-Editor wie Editor.Open RSReportDesigner.config with Visual StudioVisual Studio or a simple text editor such as Notepad.

  3. Suchen Sie das Data -Element in der Datei RSReportDesigner.config.Locate the Data element in the RSReportDesigner.config file. Im folgenden Verzeichnis muss ein Eintrag für den Datenanbieter erstellt werden:An entry for the data provider should be made in the following location:

    <Extensions>  
       <Data>  
          <Extension Your data provider configuration information goes here />  
       </Data>  
    </Extensions>  
    
  4. Fügen Sie einen Eintrag für den Datenanbieter hinzu.Add an entry for the data provider.

    AttributAttribute DescriptionDescription
    NameName Geben Sie einen eindeutigen Namen für den Datenanbieter an, z. B. MyNETDataProvider.Provide a unique name for the data provider, for example, MyNETDataProvider. Die maximale Länge für das Name -Attribut beträgt 255 Zeichen.The maximum length for the Name attribute is 255 characters. Der Name muss für sämtliche Einträge im Extension -Element einer Konfigurationsdatei eindeutig sein.The name must be unique among all entries within the Extension element of a configuration file. Der hier eingeschlossene Wert wird beim Erstellen einer neuen Datenquelle in der Dropdownliste der Datenquellentypen angezeigt.The value that you include here appears in the drop-down list of data source types when you create a new data source.
    TypType Geben Sie eine durch Trennzeichen getrennte Liste, die den vollqualifizierten Namespace der Klasse enthält, implementiert die IDbConnection -Schnittstelle, gefolgt vom Namen des der .NET Framework.NET Framework -datenanbieterassembly (nicht einschließlich der Erweiterung ".dll-Datei namens").Enter a comma-separated list that includes the fully qualified namespace of the class that implements the IDbConnection interface, followed by the name of the .NET Framework.NET Framework data provider assembly (not including the .dll file name extension).

    Für eine im Verzeichnis PrivateAssemblies von Visual StudioVisual Studio bereitgestellte DLL-Datei kann der Eintrag beispielsweise dem Folgenden ähneln:For example, the entry might resemble the following for a DLL deployed to the Visual StudioVisual Studio PrivateAssemblies directory:

    <Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly" />   
    

    Wenn Sie die Assembly in den GAC (Global Assembly Cache, globaler Assemblycache) laden, müssen Sie die Eigenschaften für starke Namen bereitstellen.If you load your assembly into the GAC, you must provide the strong name properties. Beispiel:For example:

    <Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly, Version=1.0.0.0, Culture=neutral, PublicKeyToken=MyPublicToken"/>  
    
  5. Suchen Sie das Designer -Element in der Datei RSReportDesigner.config.Locate the Designer element in the RSReportDesigner.config file. Im folgenden Verzeichnis muss ein Eintrag für den .NET Framework.NET Framework -Datenanbieter erstellt werden:An entry for the .NET Framework.NET Framework data provider should be made in the following location:

    <Extensions>  
       <Designer>  
          <Your data provider configuration information goes here>  
       </Designer>  
    </Extensions>  
    
  6. Fügen Sie der Datei RSReportDesigner.config unter dem Designer -Element den folgenden Eintrag hinzu.Add the following entry to the RSReportDesigner.config file under the Designer element. Sie müssen nur das Name -Attribut durch den in früheren Einträgen angegebenen Namen ersetzen.You need to replace only the Name attribute with the name that you provided in previous entries.

    <Extension Name="MyNETDataProvider" Type="Microsoft.ReportingServices.QueryDesigners.GenericQueryDesigner,Microsoft.ReportingServices.QueryDesigners"/>  
    

So legen Sie die Codegruppenrichtlinie für einen .NET-Datenanbieter auf dem Berichts-Designer-Client festTo set the code group policy for a .NET data provider on the Report Designer client

  1. Erstellen Sie eine Sicherungskopie der Datei "RSPreviewPolicy.config" im Verzeichnis "PrivateAssemblies".Make a backup copy of the RSPreviewPolicy.config file in the PrivateAssemblies directory.

  2. Öffnen Sie RSPreviewPolicy.config in Visual StudioVisual Studio oder einem einfachen Text-Editor, z. B. im Windows-Editor.Open RSPreviewPolicy.config with Visual StudioVisual Studio or a simple text editor, such as Notepad.

  3. Suchen Sie das CodeGroup -Element in der Datei RSPreviewPolicy.config.Locate the CodeGroup element in the RSPreviewPolicy.config file.

  4. Fügen Sie eine Codegruppe für die .NET Framework.NET Framework -Datenanbieterassembly hinzu, durch die die Berechtigung FullTrust erteilt wird.Add a code group for the .NET Framework.NET Framework data provider assembly that grants FullTrust permission. Die Codegruppe könnte beispielsweise der Folgenden ähneln:Your code group might resemble the following:

    <CodeGroup class="UnionCodeGroup"  
       version="1"  
       PermissionSetName="FullTrust"  
       Name="ThisDataProviderCodeGroup"  
       Description="Code group for the .NET data provider">  
          <IMembershipCondition class="UrlMembershipCondition"  
             version="1"  
             Url=  
    " C:\Program Files\Microsoft Visual Studio 9\Common7\IDE\PrivateAssemblies\DataProviderAssembly.dll"  
           />  
    </CodeGroup>  
    

    Die URL-Mitgliedschaft ist eine der vielen Mitgliedschaftsbedingungen, die Sie für den Datenanbieter auswählen können.URL membership is only one of many membership conditions you might select for the data provider.

Überprüfen der Bereitstellung und der Registrierung auf dem Berichts-Designer-ClientVerifying the Deployment and Registration on the Report Designer Client

Sie können die Bereitstellung erst überprüfen, wenn Sie alle Instanzen von Visual StudioVisual Studio auf Ihrem lokalen Computer geschlossen haben.Before you can verify deployment, you must close all instances of Visual StudioVisual Studio on your local computer. Wenn Sie alle aktuellen Sitzungen beendet haben, können Sie überprüfen, ob der Datenanbieter erfolgreich für den Berichts-Designer bereitgestellt wurde, indem Sie in Visual StudioVisual Studioein neues Berichtsprojekt erstellen.After you have ended all current sessions, you can verify whether your data provider was deployed successfully to Report Designer by creating a new report project in Visual StudioVisual Studio. Der Datenanbieter sollte beim Erstellen eines neuen Datasets für den Bericht in der Liste der verfügbaren Datenquellentypen aufgeführt werden.The data provider should be included in the list of available data source types when you create a new data set for your report.

Bedingungen bezüglich der PlattformPlatform Considerations

Auf einer 64-Bit-Plattform (x64) wird SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) im 32-Bit-WOW-Modus ausgeführt.On a 64-bit (x64) platform, SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) runs in 32-bit WOW mode. Wenn Sie Berichte auf einer x64-Plattform erstellen, müssen auf dem Berichterstellungsclient 32-Bit-Datenanbieter installiert sein, um eine Vorschau der Berichte zu ermöglichen.When you author reports on an x64 platform, you need 32-bit data providers installed on the report authoring client in order to preview your reports. Wenn Sie den Bericht in demselben System veröffentlichen, benötigen Sie x64-Datenanbieter zum Anzeigen des Berichts im Berichts-Manager.If you publish the report on the same system, you need x64 data providers to view the report with Report Manager.

SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) wird für ItaniumItanium-basierte Plattformen nicht unterstützt.-based platforms.

Die mit Reporting ServicesReporting Services installierten Datenverarbeitungserweiterungen müssen für jede Plattform systemintern kompiliert und in den richtigen Verzeichnissen installiert werden.The data processing extensions that are installed with Reporting ServicesReporting Services must be compiled natively for each platform and installed in the correct locations. Wenn Sie einen benutzerdefinierten Datenanbieter oder einen .NET Framework.NET Framework -Standarddatenanbieter registrieren, muss dieser systemintern für die betreffende Plattform kompiliert und im entsprechenden Verzeichnis installiert werden.If you register a custom data provider or a standard .NET Framework.NET Framework data provider, it needs to be compiled natively for the appropriate platform and installed the appropriate locations. Wenn Sie diesen auf einer 32-Bit-Plattform ausführen, muss der Datenanbieter für eine 32-Bit-Plattform kompiliert werden.If you are running on a 32-bit platform, the data provider must be compiled for a 32-bit platform. Wenn Sie ihn auf einer 64-Bit-Plattform ausführen, muss der Datenanbieter für die 64-Bit-Plattform kompiliert werden.If you are running on a 64-bit platform, the data provider must be compiled for the 64-bit platform. Sie können keinen 32-Bit-Datenanbieter verwenden, der in 64-Bit-Schnittstellen für eine 64-Bit-Plattform eingeschlossen ist.You cannot use a 32-bit data provider wrapped with 64-bit interfaces on a 64 bit platform. Überprüfen Sie Ihre Drittanbietersoftware auf Informationen dazu, ob der Datenanbieter für die installierte Plattform verwendet werden kann.Check your third-party software for information about whether the data provider will work on the installed platform. Weitere Informationen zu Datenanbietern und zur Plattformunterstützung finden Sie unter Von Reporting Services unterstützte Datenquellen (SSRS).For more information about data providers and platform support, see Data Sources Supported by Reporting Services (SSRS).

Siehe auchSee Also

Konfigurieren und Verwalten eines Berichtsservers (einheitlicher SSRS-Modus) Configure and Administer a Report Server (SSRS Native Mode)
Implementieren von Datenverarbeitungserweiterungen Implementing a Data Processing Extension
Reporting Services-Konfigurationsdateien Reporting Services Configuration Files
Codezugriffssicherheit in Reporting Services Code Access Security in Reporting Services