Personalizzare i parametri di estensione per il rendering in RSReportServer.config.Customize Rendering Extension Parameters in RSReportServer.Config

È possibile specificare i parametri di estensione per il rendering nel file di configurazione RSReportServer per sostituire il comportamento di rendering predefinito per i report in esecuzione in un server di report di Reporting ServicesReporting Services .You can specify rendering extension parameters in the RSReportServer configuration file to override default report rendering behavior for reports that run on a Reporting ServicesReporting Services report server. È possibile modificare i parametri di estensione per il rendering per ottenere gli obiettivi seguenti:You can modify rendering extension parameters to achieve the following objectives:

  • Modificare il nome dell'estensione per il rendering nell'elenco Esporta sulla barra degli strumenti del report, cambiando, ad esempio, "Archivio Web" in "MHTML" oppure localizzare il nome in una lingua diversa.Change how the rendering extension name appears in the Export list of the report toolbar (for example, to change "Web archive" to "MHTML"), or localize the name to a different language.

  • Creare più istanze della stessa estensione per il rendering, per supportare diverse opzioni di presentazione del report, ad esempio versioni con orientamento orizzontale e verticale dell'estensione per il rendering delle immagini.Create multiple instances of the same rendering extension to support different report presentation options (for example, a portrait and landscape mode version of the Image rendering extension).

  • Modificare i parametri di estensione per il rendering predefiniti per utilizzare valori diversi. Il formato di output predefinito dell'estensione per il rendering delle immagini è, ad esempio, TIFF, ma è possibile modificare i parametri di estensione affinché venga utilizzato il formato EMF.Change the default rendering extension parameters to use different values (for example, the Image rendering extension uses TIFF as the default output format; you can modify the extension parameters to use EMF instead).

    La modifica dei parametri di estensione per il rendering influisce solo sulle operazioni di rendering nel server di report.Changing the rendering extension parameters only affects rendering operations on the report server. Non è possibile sostituire le impostazioni dell'estensione per il rendering in un'anteprima del report in Progettazione report.You cannot override rendering extension settings in report preview in Report Designer.

    La definizione dei parametri di estensione per il rendering nei file di configurazione influisce globalmente sulle estensioni per il rendering.Specifying rendering extension parameters in the configuration files affects rendering extensions globally. Le impostazioni nei file di configurazione sono utilizzate al posto dei valori predefiniti ogni volta che viene utilizzata un'estensione per il rendering specifica.The settings in the configuration files are used in place of default values whenever a particular rendering extension is used. Se si vuole impostare i parametri di estensione per il rendering per un'operazione di rendering o per un report specifico, è necessario specificare le informazioni sul dispositivo a livello di programmazione tramite il metodo Render o nell'URL di un report.If you want to set rendering extension parameters for a specific report or render operation, you must specify device information programmatically using the Render method or by specifying device information settings on a report URL. Per altre informazioni sulla definizione delle impostazioni relative alle informazioni sul dispositivo per un'operazione di rendering e per visualizzare l'elenco completo di tali impostazioni, vedere Passaggio delle impostazioni relative alle informazioni sul dispositivo alle estensioni per il rendering.For more information about specifying device information settings for a render operation, and to view the complete list of device information settings, see Passing Device Information Settings to Rendering Extensions.

Individuazione e modifica del file RSReportServer.configFinding and Modifying RSReportServer.config

Le impostazioni di configurazione per i formati di output del report vengono specificate come parametri di estensione per il rendering nel file RSReportServer.config.Configuration settings for report output formats are specified as rendering extension parameters in the RSReportServer.config file. Per specificare i parametri di estensione per il rendering nei file di configurazione, è necessario saper definire le strutture XML per l'impostazione dei parametri di rendering.To specify rendering extension parameters in the configuration files, you must know how to define the XML structures that set rendering parameters. È possibile modificare due strutture XML:There are two XML structures that you can modify:

  • L'elemento OverrideNames definisce il nome visualizzato e la lingua dell'estensione per il rendering.The OverrideNames element defines the display name and language of the rendering extension.

  • La struttura XML DeviceInfo definisce le impostazioni relative alle informazioni sul dispositivo usate da un'estensione per il rendering.The DeviceInfo XML structure defines the device information settings that are used by a rendering extension. La maggior parte dei parametri di estensione per il rendering viene specificata come impostazioni relative alle informazioni sul dispositivo.Most rendering extension parameters are specified as device information settings.

    Per modificare il file, è possibile utilizzare un editor di testo.You can use a text editor to modify the file. Il file RSReportServer.config si trova nella cartella \Reporting Services\Report Server\Bin.The RSReportServer.config file can be found in the \Reporting Services\Report Server\Bin folder. Per ulteriori informazioni sulla modifica dei file di configurazione, vedere modificare un File di configurazione di Reporting Services ( RSReportServer. config ) .For more information about modifying configuration files, see Modify a Reporting Services Configuration File (RSreportserver.config).

Modifica del nome visualizzatoChanging the Display Name

Il nome di un'estensione per il rendering viene visualizzato nell'elenco Esporta sulla barra degli strumenti del report.The display name for a rendering extension appears in the Export list of the report toolbar. Tra i nomi visualizzati predefiniti vi sono Archivio Web, File TIFF e File Acrobat (PDF).Examples of default display names include Web archive, TIFF file, and Acrobat (PDF) file. È possibile sostituire il nome visualizzato predefinito con un valore personalizzato specificando l'elemento OverrideNames nei file di configurazione.You can replace the default display name with a custom value by specifying the OverrideNames element in the configuration files. Se si stanno definendo due istanze di un'unica estensione per il rendering, è anche possibile usare l'elemento OverrideNames per distinguere ogni istanza nell'elenco Esporta.In addition, if you are defining two instances of a single rendering extension, you can use the OverrideNames element to distinguish each instance in the Export list.

Poiché i nomi visualizzati sono localizzati, se si sta sostituendo il nome visualizzato predefinito con un valore personalizzato, è necessario impostare l'attributo Language .Because display names are localized, you must set the Language attribute if you are replacing the default display name with a custom value. In caso contrario, eventuali nomi specificati verranno ignorati.Otherwise, any name that you specify will be ignored. La lingua impostata deve essere valida per il computer del server di report.The language value that you set must be valid for the report server computer. Se, ad esempio, il server di report è in esecuzione in un sistema operativo francese, è necessario specificare "fr-FR" come valore dell'attributo.For example, if the report server is running on a French operating system, you should specify "fr-FR" as the attribute value.

Nell'esempio seguente viene illustrato come definire un nome personalizzato in un server di report inglese:The following example illustrates how to provide a custom name on an English report server:

<Extension Name="XML" Type="Microsoft.ReportingServices.Rendering.DataRenderer.XmlDataReport,Microsoft.ReportingServices.DataRendering">  
   <OverrideNames>  
     <Name Language="en-US">My Custom Display Name for XML Rendering</Name>  
   </OverrideNames>  
</Extension>  

Modifica delle impostazioni relative alle informazioni sul dispositivoChanging Device Information Settings

Per modificare le impostazioni predefinite relative alle informazioni sul dispositivo usare da un'estensione per il rendering già distribuita nel server di report, digitare la struttura XML DeviceInfo nei file di configurazione.To modify default device information settings that are used by a rendering extension that is already deployed on your report server, you must type the DeviceInfo XML structure into the configuration files. Ogni estensione per il rendering supporta impostazioni relative alle informazioni sui dispositivi specifici per quella estensione.Every rendering extension supports device information settings that are unique to that extension. Per l'elenco completo delle impostazioni relative alle informazioni sul dispositivo, vedere Passaggio delle impostazioni relative alle informazioni sul dispositivo alle estensioni per il rendering.To view the complete list of device information settings, see Passing Device Information Settings to Rendering Extensions.

Nell'esempio seguente vengono illustrate la struttura XML e la sintassi per la modifica delle impostazioni predefinite dell'estensione per il rendering delle immagini:The following example provides an illustration of the XML structure and syntax that modifies the default settings of the Image rendering extension:

<Render>  
    <Extension Name="IMAGE (EMF)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">  
        <OverrideNames>  
            <Name Language="en-US">Image (EMF)</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <ColorDepth>32</ColorDepth>  
                <DpiX>300</DpiX>  
                <DpiY>300</DpiY>  
                <OutputFormat>EMF</OutputFormat>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
</Render>  

Configurazione di più voci per un'estensione per il renderingConfiguring Multiple Entries for a Rendering Extension

È possibile creare più istanze della stessa estensione per il rendering, per supportare diverse opzioni di presentazione del report.You can create multiple instances of the same rendering extension to support different report presentation options. Per ogni istanza definita è possibile specificare una diversa combinazione di valori dei parametri.Each instance that you define can have a different combination of parameter values. Quando si definiscono nuove istanze di un'estensione per il rendering esistente, accertarsi di eseguire le operazioni seguenti:When defining new instances of an existing rendering extension, be sure to do the following:

  • Specificare un nome univoco per l'estensione.Specify a unique name for the extension.

    L'attributo Nome di ogni istanza deve avere un valore univoco.Each instance must have a unique value for the Name attribute. Nell'esempio seguente vengono utilizzati i nomi "IMAGE (EMF Landscape)" e "IMAGE (EMF Portrait)" per distinguere tra le due istanze.The following example uses the names "IMAGE (EMF Landscape)" and "IMAGE (EMF Portrait)" to distinguish between the two instances.

    Fare attenzione quando si modifica il nome di un'estensione per il rendering già distribuita.Use caution when changing the name of a rendering extension that is already deployed. Gli sviluppatori che specificano estensioni per il rendering a livello di programmazione utilizzano i nomi delle estensioni per identificare l'istanza da utilizzare per un'operazione di rendering specifica.Developers who specify rendering extensions programmatically use the extension name to identify which instance to use for a particular render operation. Se nel server di report sono in esecuzione applicazioni di Reporting ServicesReporting Services personalizzate, verificare che lo sviluppatore sia informato se si modifica il nome di un'estensione esistente o se ne aggiunge uno nuovo.If you are running custom Reporting ServicesReporting Services applications on your report server, make sure that the developer knows if you modify an existing extension name or add a new one.

  • Specificare un nome visualizzato univoco per consentire agli utenti di comprendere le differenze per ogni formato di output.Specify a unique display name so that users can understand the differences for each output format.

    Se si configurano più versioni della stessa estensione, è possibile assegnare a ogni versione un nome univoco specificando un valore per OverrideNames.If you are configuring multiple versions of the same extension, you can give each version a unique name by providing a value for OverrideNames. In caso contrario, nell'elenco relativo alle opzioni di esportazione sulla barra degli strumenti del report tutte le versioni dell'estensione avranno lo stesso nome.Otherwise, all versions of the extension will appear to have the same name in the Export options list on the report toolbar.

    Nell'esempio seguente viene illustrato come utilizzare l'estensione per il rendering delle immagini predefinita, che prevede la creazione di output in formato TIFF, per generare un output in formato EMF con orientamento verticale insieme a una seconda istanza per l'output di report in formato EMF con orientamento orizzontale.The following example illustrates how to use the default Image rendering extension (which produces TIFF output) to output EMF in Portrait mode alongside a second instance that outputs reports in EMF in Landscape mode. Si noti che ogni estensione ha un nome univoco.Notice that each extension name is unique. Quando si testa questo esempio, ricordarsi di scegliere report che non contengano funzionalità interattive, ad esempio opzioni per mostrare o nascondere gli elementi, matrici o collegamenti drill-through, in quanto le funzionalità di questo tipo non funzionano con l'estensione per il rendering delle immagini.When testing this example, remember to choose reports that do not contain interactive features such as show/hide options, matrices, or drillthrough links (interactive features do not work in the Image rendering extension):

<Render>  
    <Extension Name="IMAGE (EMF Landscape)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">  
        <OverrideNames>  
            <Name Language="en-US">EMF in Landscape Mode</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <OutputFormat>EMF</OutputFormat>  
                <PageHeight>8.5in</PageHeight>  
                <PageWidth>11in</PageWidth>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
    <Extension Name="IMAGE (EMF Portrait)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">  
        <OverrideNames>  
            <Name Language="en-US">EMF in Portait Mode</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <OutputFormat>EMF</OutputFormat>  
                <PageHeight>11in</PageHeight>  
                <PageWidth>8.5in</PageWidth>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
</Render>  

Vedere ancheSee Also

File di configurazione RsReportServer.config RsReportServer.config Configuration File
File di configurazione RSReportDesigner RSReportDesigner Configuration File
CSV Device Information Settings CSV Device Information Settings
Excel Device Information Settings Excel Device Information Settings
HTML Device Information Settings HTML Device Information Settings
Image Device Information Settings Image Device Information Settings
MHTML Device Information Settings MHTML Device Information Settings
PDF Device Information Settings PDF Device Information Settings
XML Device Information SettingsXML Device Information Settings