Distribuzione di un'estensione per il renderingDeploying a Rendering Extension

Dopo avere scritto e compilato il Reporting ServicesReporting Services report estensione per il rendering in un .NET Framework.NET Framework libreria, è necessario renderla individuabile dal server di report e da Progettazione Report.After you have written and compiled your Reporting ServicesReporting Services report rendering extension into a .NET Framework.NET Framework library, you need to make it discoverable by the report server and by Report Designer. A tale scopo, copiare l'estensione nella directory appropriata e aggiungere voci ai file di configurazione di Reporting ServicesReporting Services appropriati.To do so, copy the extension to the appropriate directory and add entries to the appropriate Reporting ServicesReporting Services configuration files.

Elemento di estensione del rendering del file di configurazioneConfiguration File Rendering Extension Element

Dopo avere compilato un'estensione per il rendering in una DLL, è necessario aggiungere una voce al file rsreportserver.config.Once a rendering extension has been compiled into a .DLL, you add an entry into the rsreportserver.config file. Per impostazione predefinita, il percorso è %ProgramFiles%\Microsoft SQL Server\MSRS10_50. <InstanceName > Services\ReportServer.By default, the location is %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<InstanceName>\Reporting Services\ReportServer. L'elemento padre è <eseguire il rendering >.The parent element is <Render>. Sotto l'elemento Render è presente un elemento Extension per ogni estensione per il rendering.Under the Render element is an Extension element for each rendering extension. L'elemento Extension contiene due attributi, Name e Type.The Extension element contains two attributes, Name and Type.

Nella tabella riportata di seguito vengono descritti gli attributi relativi all'elemento Extension per le estensioni per il rendering:The following table describes the attributes for the Extension element for rendering extensions:

AttributeAttribute DescrizioneDescription
NomeName Nome univoco dell'estensione.A unique name for the extension. La lunghezza massima consentita per l'attributo Name è 255 caratteri.The maximum length for the Name attribute is 255 characters. Il nome deve essere univoco all'interno di tutte le voci dell'elemento Extension di un file di configurazione.The name must be unique among all entries within the Extensions element of a configuration file. Se è presente un nome duplicato, il server di report restituirà un errore.If a duplicate name is present, the report server returns an error.
TipoType Elenco delimitato da virgole che include lo spazio dei nomi completo insieme al nome dell'assembly.A comma-separated list that includes the fully qualified namespace along with the name of the assembly.
VisibleVisible Il valore false indica che l'estensione per il rendering non deve essere visibile nelle interfacce utente.A value of false indicates that the rendering extension should not be visible in user interfaces. Se l'attributo non è incluso, il valore predefinito è true.If the attribute is not included, the default value is true.
LogAllExecutionRequestsLogAllExecutionRequests Il valore false indica che una voce viene registrata solo per la prima esecuzione del report in una sessione.A value of false indicates that an entry is logged for only the first report execution in a session. Se l'attributo non è incluso, il valore predefinito è true.If the attribute is not included, the default value is true.

Questa impostazione determina ad esempio se registrare una voce solo per la prima pagina di cui viene eseguito il rendering in un report (quando il valore è false) o una voce per ogni pagina sottoposta a rendering nel report (quando il valore è true).For example, this setting determines whether to log an entry for only the first page rendered in a report (when false) or an entry for each page rendered in the report (when true).

Per altre informazioni, vedere File di configurazione RsReportServer.config.For more information, see RsReportServer.config Configuration File.

Distribuzione dell'estensione nel server di reportDeploying the Extension to the Report Server

Il server di report usano le estensioni per il rendering per esportare i report in altri formati.The report server uses rendering extensions to export reports to other formats. È necessario distribuire l'assembly dell'estensione per il rendering nel server di report come assembly privato.You should deploy your rendering extension assembly to the report server as a private assembly. È inoltre necessario immettere una voce nel file di configurazione del server di report, rsreportserver.config.You also need to make an entry in the report server configuration file, rsreportserver.config.

Per distribuire l'assemblyTo deploy the assembly

  1. Copiare l'assembly dal percorso di gestione temporanea nella directory bin del server di report in cui si desidera usare l'estensione per il rendering.Copy your assembly from your staging location to the bin directory of the report server on which you want to use the rendering extension. Il percorso predefinito della directory Bin del server di report è %ProgramFiles%\Microsoft SQL Server\MSRS10_50. <InstanceName > Services\ReportServer\bin.The default location of the report server Bin directory is %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<InstanceName>\Reporting Services\ReportServer\Bin.

  2. Dopo aver copiato il file di assembly, aprire il file rsreportserver.config,After the assembly file is copied, open the rsreportserver.config file. situato nella directory bin del server di report.The rsreportserver.config file is also located in the report server bin directory. È necessario immettere una voce nel file di configurazione per il file di assembly dell'estensione.You need to make an entry in the configuration file for your extension assembly file. È possibile aprire il file con Visual StudioVisual Studio o un semplice editor di testo.You can open the file with Visual StudioVisual Studio or a simple text editor.

    Per altre informazioni, vedere File di configurazione RsReportServer.config.For more information, see RsReportServer.config Configuration File.

  3. Individuare l'elemento Render nel file Rsreportserver.config.Locate the Render element in the Rsreportserver.config file. È necessario immettere una voce per l'estensione appena creata nel percorso seguente:An entry for your newly created extension should be made in the following location:

    <Extensions>  
       <Render>  
          <extension configuration>  
       </Render>  
    </Extensions>  
    
  4. Aggiungere una voce per l'estensione per il rendering.Add an entry for your rendering extension. La voce deve includere un elemento con valori per Name e Typee deve essere simile a quanto riportato di seguito:Your entry should include an element that has values for Name and Type, and might look like the following:

    <Extension Name="My Rendering Extension Name" Type="CompanyName.ExtensionName.MyRenderingProvider, AssemblyName" />  
    

    Il valore per Name è il nome univoco dell'estensione per il rendering.The value for Name is the unique name of the rendering extension. Il valore per tipo è un elenco delimitato da virgole che include una voce per lo spazio dei nomi completo il IRenderingExtension implementazione, seguito dal nome dell'assembly (senza l'estensione del file con estensione dll).The value for Type is a comma-separated list that includes an entry for the fully qualified namespace of your IRenderingExtension implementation, followed by the name of your assembly (not including the .dll file extension). Per impostazione predefinita, le estensioni per il rendering sono visibili.By default, rendering extensions are visible. Per nascondere un'estensione dalle interfacce utente, come Gestione report, aggiungere un attributo Visible all'elemento Extension e impostarlo su false.To hide an extension from user interfaces, such as Report Manager, add a Visible attribute to the Extension element, and set it to false.

Verifica della distribuzioneVerifying the deployment

È inoltre possibile aprire Gestione report e verificare che l'estensione sia inclusa nell'elenco dei tipi di esportazione disponibili per un report.You can also open Report Manager and verify that your extension is included in the list of available export types for a report.

Vedere ancheSee Also

Implementazione di un'estensione per il Rendering Implementing a Rendering Extension
Cenni preliminari sulle estensioni di rendering Rendering Extensions Overview
Implementazione dell'interfaccia IRenderingExtension Implementing the IRenderingExtension Interface
Considerazioni sulla sicurezza per le estensioniSecurity Considerations for Extensions