Rendering in formato HTML (Generatore report e SSRS)Rendering to HTML (Report Builder and SSRS)

L'estensione per il rendering HTML esegue il rendering di un report impaginato in formato HTML.The HTML rendering extension renders a paginated report in HTML format. Può inoltre generare pagine HTML complete o frammenti di HTML da incorporare in altre pagine HTML.The rendering extension can also produce fully formed HTML pages or fragments of HTML to embed in other HTML pages. Tutto il codice HTML viene generato con la codifica UTF-8.All HTML is generated with UTF-8 encoding.

L'estensione per il rendering HTML è quella predefinita per i report visualizzati in un browser, anche se eseguiti nel portale Web di SQL Server 2016 Reporting Services (SSRS)SQL Server 2016 Reporting Services (SSRS) .The HTML rendering extension is the default rendering extension for reports that are viewed in a browser, including when run in the SQL Server 2016 Reporting Services (SSRS)SQL Server 2016 Reporting Services (SSRS) web portal.

L'estensione per il rendering HTML è quella predefinita per i report visualizzati in un browser, anche se eseguiti nel portale Web di SQL Server 2016 Reporting Services (SSRS)SQL Server 2016 Reporting Services (SSRS) .The HTML rendering extension is the default rendering extension for reports that are viewed in a browser, including when run in the SQL Server 2016 Reporting Services (SSRS)SQL Server 2016 Reporting Services (SSRS) web portal. L'estensione per il rendering HTML può generare frammenti HTML o documenti HTML completi.The HTML rendering extension can render HTML as a fragment or as a full HTML document. Se viene generato un frammento HTML, i tag HEAD, HTMLe BODY del documento HTML vengono rimossi.If the HTML is a fragment, the HEAD, HTML, and BODY tags of the HTML document are removed. Viene eseguito il rendering solo del contenuto del tag BODY .Only the contents of the BODY tag are rendered. Questa funzionalità è particolarmente utile se si desidera incorporare il frammento HTML nel codice HTML prodotto da un'altra applicazione.This is useful for embedding the HTML in the HTML produced by another application.

In alcuni scenari i parametri del report possono essere utilizzati per avviare attacchi intrusivi negli script durante il rendering di report in HTML.In some scenarios, report parameters can be used to launch script injection attacks when rendering reports to HTML. Per altre informazioni sulla sicurezza dei report, vedere Garantire la sicurezza di report e risorse.For more information about securing reports, see Secure Reports and Resources.

Per altre informazioni sui browser, vedere Supporto browser per Reporting Services e Power View.For more information about browsers, see Browser Support for Reporting Services and Power View.

Nota

È possibile creare e modificare file di definizioni report impaginati (con estensione rdl) in Generatore report e in Progettazione report di SQL Server Data Tools.You can create and modify paginated report definition (.rdl) files in Report Builder and in Report Designer in SQL Server Data Tools. Ogni ambiente di creazione offre modalità differenti per creare, aprire e salvare report ed elementi correlati.Each authoring environment provides different ways to create, open, and save reports and related items.

Rendering in formato MHTMLRendering in MHTML

L'estensione per il rendering HTML può inoltre consentire l'esecuzione del rendering dei report in formato MHTML (MIME Encapsulation of Aggregate HTML Documents).The HTML rendering extension can also render reports in MHTML (MIME Encapsulation of Aggregate HTML Documents). MHTML estende HTML per incorporare oggetti codificati, ad esempio immagini, in documenti HTML.MHTML extends HTML to embed encoded objects, such as images, in the HTML document. Tale estensione consente di incorporare risorse, quali immagini, documenti o altri file binari, come strutture MIME nel codice HTML del report, in un singolo file.Using the MHTML rendering extension, you can embed resources such as images, documents, or other binary files as MIME structures within the report HTML, into a single file. I report MHTML sono utili anche per l'incorporamento di elementi in messaggi di posta elettronica, in quanto tutte le risorse vengono incluse nel report.MHTML reports are also useful for embedding within e-mail messages because all resources are included with the report. Sebbene il rendering MHTML venga eseguito dall'estensione per il rendering HTML, talvolta questa funzionalità viene denominata anche estensione per il rendering MHTML.Although it is actually the HTML rendering extension that renders MHTML, this functionality may also be referred to as the MHTML rendering extension.

Supporto browserBrowser Support

Questa estensione per il rendering supporta le seguenti versioni di browser:This rendering extension supports the following browser versions:

  • Internet Explorer 5.5 e versioni successiveInternet Explorer 5.5 and later

  • Firefox 1.5 e versioni successiveFirefox 1.5 and later

  • Safari 3.0 e versioni successiveSafari 3.0 and later

    In considerazione delle caratteristiche dei diversi browser, è possibile che il report visualizzabile sia leggermente diverso a seconda del browser.Due to cross browser considerations, the rendered report may vary slightly from browser to browser. Ad esempio, la casella di testo contiene una proprietà chiamata WritingMode.For example, the text box contains a property called WritingMode. non supportata in Firefox.This property is not supported in Firefox.

Regole di rendering specifiche di HTMLHTML-Specific Rendering Rules

Durante il rendering vengono applicate le seguenti regole specifiche di HTML:The following HTML-specific rules are applied when rendering:

  • Il renderer compila una struttura di tabella HTML in cui inserire tutti gli elementi di ogni raccolta ReportItems , se ne esiste più di una.The renderer builds an HTML table structure to contain all of the items in each ReportItems collection, if there is more than one.

  • Ogni elemento all'interno della struttura della tabella occupa una singola cella.Every item within the table structure occupies a single cell.

  • Le celle vuote vengono compresse il più possibile per ridurre le dimensioni del codice HTML.Empty cells are collapsed together as much as possible to reduce the size of the HTML.

  • Al bordo superiore viene aggiunta una riga di celle vuote, mentre a quello sinistro viene aggiunta un'altra colonna per incrementare la velocità di rendering della tabella nei browser.A row of empty cells is added to the top edge and another column to the left edge to improve the speed at which browsers can render the table.

  • Alle righe o alle colonne della tabella che non contengono elementi, ma solo spazi tra elementi, vengono assegnate larghezze e altezze fisse.Table rows or columns that contain no items, just gaps between items, are given fixed widths and heights.

  • Le dimensioni di tutte le altre righe e colonne possono aumentare in base alle dimensioni dei singoli elementi del report.All other rows and columns are allowed to grow depending on the size of each report item.

  • Tutte le coordinate e le dimensioni degli elementi del report vengono convertite in millimetri.All coordinates and report item sizes are converted to millimeters. Tutte le altre dimensioni, incluse le proprietà dello stile, mantengono le unità di misura originali.All other sizes, including style properties, retain their original units. Le differenze di dimensioni e posizioni inferiori a 0,2 mm vengono considerate come 0 mm.Size and position differences smaller than .2mm are treated as 0mm.

InterattivitàInteractivity

In HTML sono supportati alcuni elementi interattivi.Some interactive elements are supported in HTML. Di seguito è riportata una descrizione di comportamenti specifici.The following is a description of specific behaviors.

Elementi visualizzati e nascostiShow and Hide

Il rendering di un elemento del report la cui visibilità può essere attivata o disattivata prevede l'inclusione di un'immagine dell'elemento Toggle (+/-). Tale elemento è inoltre selezionabile con il mouse.A report item whose visibility can be toggled is rendered with a +/- toggle image and is clickable. Quando si fa clic sull'elemento, viene effettuata una nuova chiamata al server per eseguire il rendering dell'output con lo stato di visualizzazione modificato.When the item is clicked, a call back to the server takes place in order to re-render the output with the changed show or hide state.

Mappa documentoDocument Map

È possibile eseguire il rendering di etichette della mappa documento e passare a esse utilizzando la mappa documento nel controllo visualizzatore.Document map labels are rendered and can be navigated to by using the document map in the viewer control. Per le intestazioni omesse dell'area dati, il rendering delle etichette viene eseguito sulla prima cella figlio.For omitted data region headers, labels are rendered on the first child cell. Se non è presente alcuna cella figlio, il rendering dell'etichetta viene eseguito sull'elemento figlio che la precede.If there is no child cell present, the label is rendered on the child that precedes it.

SegnalibriBookmarks

I collegamenti a segnalibro vengono sottoposti a rendering e visualizzati come collegamenti ipertestuali.Bookmark links are rendered and appear as hyperlinks. È possibile eseguire il rendering di destinazioni dei segnalibri e passare a esse facendo clic sui collegamenti a segnalibro.Bookmark targets are rendered and can be navigated to by clicking the bookmark links. Quando si fa clic su un collegamento a un segnalibro, il report passa alla prima occorrenza dell'etichetta del segnalibro di destinazione. Se possibile, il contenuto della finestra del browser viene fatto scorrere in modo che il collegamento sia visualizzato all'inizio della finestra.When a bookmark link is clicked, the report goes to the first occurrence of the target bookmark label and, when possible, the browser is scrolled so that the bookmark link is at the top of the window. Per contrassegnare le destinazioni dei segnalibri, vengono usati i tag di ancoraggio HTML (<a>).HTML anchor (<a>) tags are used to mark bookmark targets.

Ordinamento interattivoInteractive Sorting

Se per una casella di testo è stato definito l'ordinamento dell'utente, l'estensione per il rendering HTML esegue il rendering delle icone di ordinamento nella casella di testo a destra del relativo contenuto.If a text box has user sort defined, the HTML rendering extension renders the sort icons in the text box to the right of its contents. Se un report contiene una casella di testo in cui è stato definito l'ordinamento dell'utente, viene eseguito il rendering del codice JavaScript che provoca un postback al server quando si fa clic sull'icona di ordinamento.If a report contains any text box where user sort is defined, JavaScript is rendered that causes a postback to the server when the sort image is clicked.

Il rendering di collegamenti ipertestuali e collegamenti drill-through restituisce collegamenti ipertestuali in elementi del report racchiudendo l'elemento in cui sono definiti tra tag di ancoraggio HTML (<a>).Hyperlinks and drillthrough links are rendered as hyperlinks on report items using the HTML anchor (<a>) tags around the item on which they are defined.

La caratteristica Cerca consente agli utenti di cercare una stringa di testo all'interno del report.The Search feature allows users to search for a string of text within the report.

Ulteriori funzionalità di ricerca vengono fornite dal controllo Web Form ReportViewer.Additional search and find functionality is provided by the ReportViewer Web Forms control.

Impostazioni relative alle informazioni sul dispositivoDevice Information Settings

Modificando le impostazioni relative alle informazioni sul dispositivo, è possibile modificare alcune impostazioni predefinite per questo renderer, tra cui la modalità di rendering.You can change some default settings for this renderer, including which mode to render in, by changing the device information settings. Per altre informazioni, vedere Impostazioni relative alle informazioni sul dispositivo HTML.For more information, see HTML Device Information Settings.

Vedere ancheSee Also

Paginazione in Reporting Services (Generatore report e SSRS) Pagination in Reporting Services (Report Builder and SSRS)
Tipi di rendering (Generatore report e SSRS) Rendering Behaviors (Report Builder and SSRS)
Funzionalità interattiva per estensioni per il rendering di report differenti (Generatore report e SSRS) Interactive Functionality for Different Report Rendering Extensions (Report Builder and SSRS)
Rendering degli elementi del report (Generatore report e SSRS) Rendering Report Items (Report Builder and SSRS)
Tabelle, matrici ed elenchi (Generatore report e SSRS)Tables, Matrices, and Lists (Report Builder and SSRS)