Paginazione in Reporting Services (Generatore report e SSRS)Pagination in Reporting Services (Report Builder and SSRS)

Il termine paginazione si riferisce al numero di pagine all'interno di un report e alla disposizione degli elementi del report in tali pagine.Pagination refers to the number of pages within a report and how report items are arranged on these pages. In Reporting ServicesReporting Services la paginazione varia a seconda dell'estensione per il rendering usata per visualizzare e recapitare il report.Pagination in Reporting ServicesReporting Services varies depending on the rendering extension you use to view and deliver the report. Quando si esegue un report sul server di report, viene usato il renderer HTML.When you run a report on the report server, the report uses the HTML renderer. Tale renderer si attiene a un set specifico di regole di paginazione.HTML follows a specific set of pagination rules. Se ad esempio si esporta lo stesso report in formato PDF, viene usato il renderer PDF e viene applicato un set di regole differente, pertanto il report viene impaginato in modo diverso.If you export the same report to PDF, for example, the PDF renderer is used and a different set of rules are applied; therefore, the report paginates differently. Per progettare correttamente un report di facile lettura e ottimizzato per il renderer che si intende usare per recapitare il report, è necessario comprendere le regole usate per controllare la paginazione in Reporting ServicesReporting Services.To successfully design an easy-to-read report for your users that is optimized for the renderer that you plan to use to deliver your report, you need to understand the rules used to control pagination in Reporting ServicesReporting Services.

In questo argomento viene illustrato l'impatto delle dimensioni della pagina fisica e del layout del report sul rendering del report eseguito mediante renderer di interruzioni di pagina manuali.This topic discusses the impact of the physical page size and the report layout on how hard page break renderers render the report. È possibile impostare le proprietà per modificare le dimensioni e i margini delle pagine fisiche e dividere il report in colonne nei riquadri Proprietà report e Proprietà o nella finestra di dialogo Imposta pagina .You can set properties to modify the physical page size and margins, and divide the report into columns, by using the Report Properties pane, the Properties pane, or the Page Setup dialog box. Per accedere al riquadro Proprietà report , fare clic sull'area blu all'esterno del corpo del report.You access the Report Properties pane by clicking the blue area outside the report body. Per accedere alla finestra di dialogo Imposta pagina , fare clic su Esegui nella scheda Home, quindi fare clic su Imposta pagina nella scheda Esegui.You access the Page Setup dialog box by clicking Run on the Home tab, and then clicking Page Setup on the Run tab.

Nota

Se un report è stato progettato in modo da occupare la larghezza di una pagina, ma il rendering viene eseguito su più pagine, verificare che la larghezza del corpo del report, inclusi i margini, non sia maggiore di quella delle dimensioni della pagina fisica.If you have designed a report to be one page wide, but it renders across multiple pages, check that the width of the report body, including margins, is not larger than the physical page size width. Per impedire l'aggiunta di pagine vuote al report, è possibile ridurre le dimensioni del contenitore trascinando l'angolo del contenitore verso sinistra.To prevent empty pages from being added to your report, you can reduce the container size by dragging the container corner to the left.

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.

Corpo del reportThe Report Body

Il corpo del report è un contenitore rettangolare visualizzato come spazio vuoto nell'area di progettazione,The report body is a rectangular container displayed as white space on the design surface. che può essere ingrandito o ridotto a seconda degli elementi del report in esso contenuti.It can grow or shrink to accommodate the report items contained within it. Il corpo del report non rispecchia le dimensioni della pagina fisica: di fatto può estendersi oltre i limiti delle dimensioni della pagina fisica fino a occupare più pagine del report.The report body does not reflect the physical page size and, in fact, the report body can grow beyond the boundaries of the physical page size to span multiple report pages. Alcuni renderer, quali Microsoft ExcelMicrosoft Excel, Word, HTML e MHTML, eseguono il rendering di report che vengono ingranditi o ridotti a seconda del contenuto della pagina.Some renderers, such as Microsoft ExcelMicrosoft Excel, Word, HTML and MHTML, render reports that grow or shrink depending on the contents of the page. I report di cui viene eseguito il rendering in tali formati sono ottimizzati per la visualizzazione su schermo, ad esempio in un Web browser.Reports rendered in these formats are optimized for screen-based viewing, such as in a Web browser. Tali renderer aggiungono interruzioni di pagina verticali quando necessario.These renderers add vertical page breaks when required.

È possibile formattare il corpo del report in modo da includere un colore, uno stile e una larghezza per il bordo.You can format the report body so that there is a border color, border style and border width. È inoltre possibile aggiungere un colore e un'immagine di sfondo.You can also add a background color and background image.

Pagina fisicaThe Physical Page

Le dimensioni della pagina fisica corrispondono al formato carta.The physical page size is the paper size. Il formato carta specificato per il report controlla la modalità di rendering del report stesso.The paper size that you specify for the report controls how the report is rendered. Nei report di cui viene eseguito il rendering in formati con interruzioni di pagina manuali vengono inserite interruzioni di pagina orizzontali e verticali basate sulle dimensioni della pagina fisica per offrire un'esperienza di lettura ottimizzata quando vengono stampati o visualizzati in un formato di file con interruzioni di pagina manuali.Reports rendered in hard page break formats insert page breaks horizontally and vertically based on the physical page size to provide an optimized reading experience when printed or viewed in a hard page break file format. Nei report di cui viene eseguito il rendering in formati con interruzioni di pagina automatiche vengono inserite interruzioni di pagina orizzontali basate sulle dimensioni fisiche per offrire un'esperienza di lettura ottimizzata quando vengono visualizzati in un Web browser.Reports rendered in soft page break formats insert page breaks horizontally based on the physical size to provide an optimized reading experience when viewed in a Web browser.

Per impostazione predefinita, le dimensioni della pagina sono 8,5 x 11 pollici, ma è possibile cambiarle nella finestra di dialogo Imposta pagina o nel riquadro Proprietà report oppure modificando le proprietà PageHeight e PageWidth nel riquadro Proprietà .By default, the page size is 8.5 x 11 inches but you can change this size by using the Report Properties pane, Page Setup dialog box or by changing the PageHeight and PageWidth properties in the Properties pane. Le dimensioni della pagina non vengono aumentate o ridotte a seconda del contenuto del corpo del report.The page size does not grow or shrink to accommodate the contents of the report body. Se si desidera che il report sia visualizzato in una sola pagina, tutto il contenuto del corpo del report deve essere inserito nella pagina fisica.If you want the report to appear on a single page, all the content within the report body must fit on the physical page. Se non è possibile inserirlo e si usa il formato con interruzioni di pagina manuali, per il report saranno necessarie ulteriori pagine.If it does not fit and you use the hard page break format, then the report will require additional pages. Se il corpo del report si estende oltre il bordo destro della pagina fisica, viene inserita un'interruzione di pagina orizzontale.If the report body grows past the right edge of the physical page, then a page break is inserted horizontally. Se il corpo del report si estende oltre il bordo inferiore della pagina fisica, viene inserita un'interruzione di pagina verticale.If the report body grows past the bottom edge of the physical page, then a page break is inserted vertically.

Se si desidera eseguire l'override delle dimensioni della pagina fisica definite nel report, è possibile specificare tali dimensioni usando le impostazioni relative alle informazioni sui dispositivi per il renderer specifico usato per esportare il report.If you want to override the physical page size that is defined in the report, you can specify the physical page size using the Device Information settings for the specific renderer that you are using to export the report. Per altre informazioni, vedere Reporting Services Device Information Settings.For more information, see Reporting Services Device Information Settings.

MarginiMargins

I margini vengono tracciati dal bordo delle dimensioni della pagina fisica verso l'interno fino all'impostazione specificata.Margins are drawn from the edge of the physical page dimensions inward to the specified margin setting. Se un elemento del report si estende nell'area del margine, viene tagliato in modo da non eseguire il rendering dell'area della sovrapposizione.If a report item extends into the margin area, it is clipped so that the overlapping area is not rendered. Se per i margini si specificano dimensioni tali che la larghezza orizzontale o verticale della pagina sia uguale a zero, il valore predefinito delle impostazioni dei margini sarà uguale a zero.If you specify margin sizes that cause the horizontal or vertical width of the page to equal zero, the margin settings default to zero. I margini vengono specificati nella finestra di dialogo Imposta pagina o nel riquadro Proprietà report oppure modificando le proprietà TopMargin, BottomMargin, LeftMargin e RightMargin nel riquadro Proprietà .Margins are specified using the Report Properties pane, Page Setup dialog box or by changing the TopMargin, BottomMargin, LeftMargin and RightMargin properties in the Properties pane. Se si desidera eseguire l'override delle dimensioni dei margini definite nel report, è possibile specificare tali dimensioni usando le impostazioni relative alle informazioni sui dispositivi per il renderer specifico usato per esportare il report.If you want to override the margin size that is defined in the report, you can specify the margin size using the Device Information settings for the specific renderer that you are using to export the report.

L'area della pagina fisica disponibile in seguito all'allocazione dello spazio per margini, spaziatura delle colonne, intestazione e piè di pagina, è denominata area utilizzabile della pagina.The area of the physical page that remains after space is allocated for margins, column spacing, and the page header and footer, is called the usable page area. I margini vengono applicati solo quando si esegue il rendering e si stampano report nei formati dei renderer di interruzioni di pagina manuali.Margins are only applied when you render and print reports in hard page break renderer formats. Nell'immagine seguente sono indicati il margine e l'area utilizzabile della pagina di una pagina fisica.The following image indicates the margin and usable page area of a physical page.

Pagina fisica con margini e area utilizzabile. Physical page with margins and usable area.

Colonne in formato newsletterNewsletter-Style Columns

Il report può essere diviso in colonne, ad esempio le colonne di un giornale, che vengono considerate come pagine logiche di cui viene eseguito il rendering nella stessa pagina fisica.Your report can be divided into columns, such as columns in a newspaper, that are treated as logical pages rendered on the same physical page. Le colonne vengono disposte da sinistra verso destra e dall'alto verso il basso e sono separate tra loro da spazi vuoti.They are arranged from left to right, top to bottom, and are separated by white space between each column. Se il report è diviso in più colonne, ogni pagina fisica viene divisa verticalmente in colonne, ciascuna delle quali viene considerata come una pagina logica.If the report is divided into more than one column, each physical page is divided vertically into columns, each of which is considered a logical page. Si supponga ad esempio che in una pagina fisica siano presenti due colonne.For example, suppose you have two columns on a physical page. Il contenuto del report verrà inserito nella prima e quindi nella seconda colonna.The content of your report fills the first column and then the second column. Se le prime due colonne sono insufficienti per il contenuto del report, verranno riempite la prima e quindi la seconda colonna nella pagina successiva.If the report does not fit entirely within the first two columns, the report fills the first column and then the second column on the next page. Le colonne continuano a essere riempite, da sinistra verso destra e dall'alto verso il basso, finché non viene eseguito il rendering di tutti gli elementi del report.Columns continue to be filled, from left to right, top to bottom until all report items are rendered. Se per le colonne si specificano dimensioni tali che la larghezza orizzontale o verticale sia uguale a zero, il valore predefinito dell'impostazione relativa alla spaziatura tra le colonne sarà uguale a zero.If you specify column sizes that cause the horizontal width or vertical width to equal zero, the column spacing defaults to zero.

Le colonne vengono specificate nella finestra di dialogo Imposta pagina o nel riquadro Proprietà report oppure modificando le proprietà TopMargin, BottomMargin, LeftMargin e RightMargin nel riquadro Proprietà .Columns are specified using the Report Properties pane, Page Setup dialog box or by changing the TopMargin, BottomMargin, LeftMargin and RightMargin properties in the Properties pane. Se si desidera usare per i margini dimensioni non definite, è possibile specificare tali dimensioni usando le impostazioni relative alle informazioni sui dispositivi per il renderer specifico usato per esportare il report.If you want to use a margin size that is not defined, you can specify the margin size using the Device Information settings for the specific renderer that you are using to export the report. Le colonne vengono applicate solo quando si esegue il rendering e si stampano report nei formati PDF o Immagine.Columns are only applied when you render and print reports in PDF or Image formats. Nell'immagine seguente è indicata l'area utilizzabile di una pagina contenente colonne.The following image indicates the usable page area of a page containing columns.

Pagina fisica con colonne illustrate. Physical page with columns depicted.

Interruzioni e nomi di paginaPage Breaks and Page Names

La leggibilità di un report, così come il controllo e l'esportazione dei relativi dati potrebbero risultare migliori quando il report dispone di nomi di pagina.A report might be more readable and its data easier to audit and export when the report has page names. Reporting Services offre proprietà per report e aree dati Tablix (tabella, matrice ed elenco), gruppi e rettangoli nel report per controllare la paginazione, reimpostare i numeri di pagina e fornire nuovi nomi di pagina del report in base alle interruzioni di pagina.Reporting Services provides properties for reports and tablix data regions (table, matrix, and list), groups, and rectangles in the report to control pagination, reset page numbers, and provide new report page names on page breaks. Tali caratteristiche consentono di migliorare i report indipendentemente dal formato in cui ne viene eseguito il rendering, tuttavia risultano utili soprattutto in caso di esportazione dei report nelle cartelle di lavoro di Excel.These features can enhance reports regardless of the format in which reports are rendered, but are especially useful when exporting reports to Excel workbooks.

La proprietà InitialPageName fornisce il nome di pagina iniziale del report.The InitialPageName property provides the initial page name of the report. Se il report non include nomi di pagina per le interruzioni di pagina, il nome di pagina iniziale viene usato per tutte le nuove pagine create con le interruzioni di pagina.If your report does not include page names for page breaks, then the initial page name is used for all the new pages created by page breaks. Non è necessario usare un nome di pagina iniziale.It is not required to use an initial page name.

Un report sottoposto a rendering può fornire un nuovo nome per ogni pagina generata in seguito a un'interruzione di pagina.A rendered report can provide a new page name for the new page that a page break causes. Per creare il nome di pagina, è necessario impostare la proprietà PageName di una tabella, una matrice, elenco, gruppo o rettangolo.To provide the page name, you set the PageName property of a table, matrix, list, group, or rectangle. Non è obbligatorio specificare nomi di pagina in corrispondenza delle interruzioni.It is not required that you specify page names on breaks. Se non li si specifica, viene usato in alternativa il valore di InitialPageName.If you do not, the value of InitialPageName is used instead. Se anche InitialPageName è vuoto, la nuova pagina non ha nome.If InitialPageName is also blank, the new page has no name.

Le aree dati Tablix (tabella, matrice ed elenco), i gruppi e i rettangoli supportano le interruzioni di pagina.Tablix data regions (table, matrix, and list), groups, and rectangles support page breaks.

L'interruzione di pagina include le proprietà seguenti:The page break includes the following properties:

  • BreakLocation determina la posizione dell'interruzione per l'elemento del report abilitato dall'interruzione di pagina: all'inizio, alla fine oppure all'inizio e alla fine.BreakLocation provides the location of the break for the page break enabled report element: at the start, end, or start and end. Nei gruppi, BreakLocation può essere posizionato tra gruppi.On groups, BreakLocation can be located between groups.

  • Disabled indica se un'interruzione di pagina è applicata all'elemento di report.Disabled indicates whether a page break is applied to the report element. Se questa proprietà restituisce True, l'interruzione di pagina viene ignorata.If this property evaluates to True, the page break is ignored. Questa proprietà viene usata per disabilitare dinamicamente le interruzioni di pagina basate su espressioni durante l'esecuzione del report.This property is used to dynamically disable page breaks based on expressions when the report is run.

  • ResetPageNumber indica se il numero di pagina deve essere reimpostato su 1 quando si verifica un'interruzione di pagina.ResetPageNumberindicates whether the page number should be reset to 1 when a page break occurs. Se questa proprietà restituisce True, il numero di pagina viene reimpostato.If this property evaluates to True, the page number is reset.

    È possibile impostare la proprietà BreakLocation nelle finestre di dialogo Proprietà Tablix, Proprietà rettangoloo Proprietà gruppo , ma è necessario impostare le proprietà Disabled, ResetPageNumber e PageName nel riquadro Proprietà di Generatore report.You can set the BreakLocation property in the Tablix Properties, Rectangle Properties, or Group Properties dialog boxes, but you must set the Disabled, ResetPageNumber, and PageName properties in the Report Builder Properties pane. Se le proprietà nel riquadro Proprietà sono organizzate per categoria, sarà possibile trovarle nella categoria PageBreak .If the properties in the Properties pane are organized by category, you will find the properties in the PageBreak category. Per i gruppi, la categoria PageBreak si trova all'interno della categoria Group .For groups, the PageBreak category is inside the Group category.

    È possibile usare costanti ed espressioni semplici o complesse per impostare il valore delle proprietà Disabled e ResetPageNumber.You can use constants and simple or complex expressions to set the value of the Disabled and ResetPageNumber properties. Non è tuttavia possibile usare espressioni con la proprietà BreakLocation.However, you cannot use expression with the BreakLocation property. Per altre informazioni sulla scrittura e l'uso delle espressioni, vedere Espressioni (Generatore report e SSRS).For more information about writing and using expressions, see Expressions (Report Builder and SSRS).

    Nel report è possibile scrivere espressioni che fanno riferimento ai nomi o ai numeri di pagina correnti tramite la raccolta Globals .In your report you can write expressions that reference the current page names or page numbers by using the Globals collection. Per altre informazioni, vedere Riferimenti alle raccolte predefinite Globals e User (Generatore report e SSRS).For more information, see Built-in Globals and Users References (Report Builder and SSRS).

Denominazione delle schede del foglio di lavoro di ExcelNaming Excel Worksheet Tabs

Queste proprietà risultano utili quando si esportano report nelle cartelle di lavoro di Excel.These properties are useful when you export reports to Excel workbooks. Usare la proprietà InitialPage per specificare un nome predefinito per la scheda del foglio di lavoro quando si esporta il report e usare le interruzioni di pagina e la proprietà PageName per fornire nomi diversi per ogni foglio di lavoro.Use the InitialPage property to specify a default name for the worksheet tab name when you export the report, and use page breaks and the PageName property to provide different names for each worksheet. Ogni nuova pagina del report, definita da un'interruzione di pagina, viene esportata in un foglio di lavoro diverso denominato in base al valore della proprietà PageName.Each new report page, defined by a page break, is exported to a different worksheet named by the value of the PageName property. Se PageName è vuoto, ma il report dispone di un nome di pagina iniziale, quest'ultimo verrà usato per tutti i fogli di lavoro nella cartella di lavoro di Excel.If PageName is blank, but the report has an initial page name, then all worksheets in the Excel workbook use the same name, the initial page name.

Per altre informazioni sul funzionamento di queste proprietà in caso di esportazione dei report in Excel, vedere Esportazione in Microsoft Excel (Generatore report e SSRS).For more information about how these properties work when reports are exported to Excel, see Exporting to Microsoft Excel (Report Builder and SSRS).

Vedere ancheSee Also

Pagina Layout e Rendering ( Generatore report e SSRS )Page Layout and Rendering (Report Builder and SSRS)