Cenni preliminari sulle estensioni per il renderingRendering Extensions Overview

Un'estensione per il rendering è un componente o un modulo di un server di report che consente di trasformare le informazioni sul layout e i dati del report in un formato specifico del dispositivo.A rendering extension is a component or module of a report server that transforms report data and layout information into a device-specific format. SQL ServerSQL Server Reporting ServicesReporting Services include sette estensioni per il rendering: HTML, Excel, Word, CSV o Text, XML, immagine e PDF. Reporting ServicesReporting Services includes seven rendering extensions: HTML, Excel, Word, CSV or Text, XML, Image, and PDF. È possibile creare estensioni per il rendering aggiuntive per generare report in altri formati.You can create additional rendering extensions to generate reports in other formats.

Nota

Per determinare quali sono le estensioni per il rendering disponibili, è possibile visualizzare l'elenco delle estensioni installate nel file RSReportServer.config.To determine which rendering extensions are available, you can view the list of installed extensions in the RSReportServer.config file.

Nella tabella seguente sono descritte le estensioni per il rendering incluse in Reporting ServicesReporting Services.The following table describes the rendering extensions that are included with Reporting ServicesReporting Services.

Nome estensioneExtension Name DescriptionDescription
XMLXML Consente di eseguire il rendering di un report in formato XML.Renders a report in XML. Il report viene aperto in un browser.The report opens in a browser. Le trasformazioni aggiuntive applicate a questo output XML possono rappresentare un metodo efficace per evitare di sviluppare un'estensione per il rendering personalizzata.Additional transformations applied to this XML output may be a cost effective way of avoiding developing your own rendering extension.
CSVCSV Consente di eseguire il rendering di un report in formato con valori delimitati da virgole.Renders a report in comma-delimited format. Il report viene aperto in uno strumento di visualizzazione associato ai formati di file CSV.The report opens in a viewing tool associated with CSV file formats.
IMAGEIMAGE Consente di eseguire il rendering di un report in un formato orientato alla pagina.Renders a report in a page-oriented format. Il formato viene visualizzato come TIFF nell'elenco a discesa Esporta della barra degli strumenti del report.The format is shown as TIFF in the Export drop-down of the report toolbar.
PDFPDF Consente di eseguire il rendering di un report in Adobe Acrobat Reader.Renders a report in the Adobe Acrobat Reader. Il formato viene visualizzato come File Acrobat (PDF) nell'elenco a discesa Esporta della barra degli strumenti del report.The format is shown as Acrobat (PDF) File in the Export drop-down of the report toolbar.
EXCELEXCEL Consente di eseguire il rendering di un report in formato Microsoft ExcelMicrosoft Excel.Renders a report in Microsoft ExcelMicrosoft Excel.
WORDWORD Consente di eseguire il rendering di un report in formato Microsoft WordMicrosoft Word.Render a report in Microsoft WordMicrosoft Word.
HTML 4.0 (parte dell'estensione per il rendering HTML)HTML 4.0 (part of the HTML rendering extension) HTML è il formato utilizzato per eseguire il rendering iniziale del report.HTML is the format used to initially render the report. Se il browser supporta il formato HTML 4.0, viene utilizzato questo formato.If your browser support HTML 4.0, that is the format that is used. In caso contrario, viene utilizzato il formato HTML 3.2.Otherwise, HTML 3.2 is used.
MHTML (parte dell'estensione per il rendering HTML)MHTML (part of the HTML rendering extension) Consente di eseguire il rendering di un report in formato MHTML.Renders a report in MHTML. Il report viene aperto in Internet Explorer.The report opens in Internet Explorer. Il formato viene visualizzato come Archivio Web nell'elenco a discesa Esporta della barra degli strumenti del report.The format is shown as Web Archive in the Export drop-down of the report toolbar.
NULLNULL Non viene eseguito il rendering di un report in un formato specifico.Does not render a report to a specific format. Questa estensione per il rendering è utile per l'inserimento dei report nella cache.This rendering extension is useful for placing reports in cache. Il rendering Null deve essere utilizzato insieme a un'esecuzione o a un recapito pianificato.Null rendering should be used in conjunction with a scheduled execution or delivery.

Per ulteriori informazioni su formati consigliati e il relativo utilizzo, vedere esportazione di report ( Generatore report e SSRS ) .For more information on the recommended formats and their uses, see Export Reports (Report Builder and SSRS).

Ognuna delle estensioni per il rendering implementate da MicrosoftMicrosoft e fornite con Reporting ServicesReporting Services utilizza un set comune di interfacce.Each of the rendering extensions implemented by MicrosoftMicrosoft and shipped with Reporting ServicesReporting Services uses a common set of interfaces. Questo garantisce che ogni estensione implementi funzionalità simili e riduce la complessità del codice di rendering nel nucleo del server di report.This ensures that each extension implements comparable functionality and reduces the complexity of the rendering code in the core of the report server.

Modello a oggetti per il renderingRendering Object Model

Quando un report viene elaborato, il risultato è un modello a oggetti esposto pubblicamente noto come Modello a oggetti per il rendering (ROM, Rendering Object Model).When a report is processed, the result is a publicly exposed object model known as the Rendering Object Model (ROM). Il modello a oggetti per il rendering è una raccolta di classi che definiscono il contenuto, il layout e i dati di un report che è stato elaborato.The Rendering Object Model is a collection of classes that define the contents, layout, and data of a report that has been processed. Questo modello è disponibile per gli sviluppatori che desiderano progettare, sviluppare e distribuire estensioni per il rendering personalizzate per Reporting ServicesReporting Services.The ROM is available to developers who wish to design, develop, and deploy custom rendering extensions for Reporting ServicesReporting Services. Il modello a oggetti per il rendering viene creato quando il server di report elabora la definizione XML di un report insieme ai dati del report definiti dall'utente.ROM is produced when the report server processes a report's XML definition along with the user-defined report data. Al termine dell'elaborazione, il modello a oggetti pubblico viene utilizzato da un'estensione per il rendering per definire l'output del report.When processing is complete, the public object model is used by a rendering extension to define the output of the report. Classi pubbliche disponibili del ROM sono definite nel Microsoft.ReportingServices.OnDemandReportRendering dello spazio dei nomi.The ROM's available public classes are defined in the Microsoft.ReportingServices.OnDemandReportRendering namespace.

Creazione di estensioni per il rendering personalizzateWriting Custom Rendering Extensions

Prima di decidere di creare un'estensione per il rendering personalizzata, è consigliabile valutare alternative più semplici.Before you decide to create a custom rendering extension, you should evaluate simpler alternatives. È possibile effettuare le operazioni seguenti:You can:

  • Personalizzare l'output sottoposto a rendering specificando le impostazioni relative alle informazioni sui dispositivi per le estensioni esistenti.Customize rendered output by specifying device information settings for existing extensions.

  • Aggiungere funzionalità di presentazione e formattazione personalizzate combinando XSLT (XSL Transformations, trasformazioni XSL) con l'output del formato di rendering XML.Add custom formatting and presentation features by combining XSL Transformations (XSLT) with the output of the XML rendering format.

    La scrittura di un'estensione per il rendering personalizzata è complessa.Writing a custom rendering extension is difficult. Un'estensione per il rendering deve in genere supportare tutte le combinazioni possibili di elementi del report e richiede l'implementazione di centinaia di classi, interfacce, metodi e proprietà.A rendering extension must typically support all possible combinations of report elements and requires that you implement hundreds of classes, interfaces, methods, and properties. Se è necessario eseguire il rendering di un report in un formato che non è incluso in Reporting ServicesReporting Services e si decide di scrivere la propria implementazione di codice gestito di un'estensione per il rendering, deve implementare il codice di estensione per il rendering di Microsoft.ReportingServices.OnDemandReportRendering.IRenderingExtension interfaccia, è richiesto dal server di report.If you must render a report in a format that is not included with Reporting ServicesReporting Services and decide to write your own managed code implementation of a rendering extension, the rendering extension code must implement the Microsoft.ReportingServices.OnDemandReportRendering.IRenderingExtension interface, which is required by the report server.

    Per documentazione e white paper aggiuntivi su Reporting ServicesReporting Services, vedere le risorse tecniche più recenti nel sito Web di Reporting Services.For supplemental documentation and whitepapers on Reporting ServicesReporting Services, see the latest technical resources at the Reporting Services Web site.

Vedere ancheSee Also

Implementazione di un'estensione per il Rendering Implementing a Rendering Extension
Libreria di estensioni di Reporting ServicesReporting Services Extension Library