Raccolte predefinite - alle raccolte predefinite Globals e Users riferimenti (Generatore Report)Built-in Collections - Built-in Globals and Users References (Report Builder)

La raccolta di campi predefinita, in cui sono incluse le raccolte Globals e User , rappresenta i valori globali forniti da Reporting Services durante l'elaborazione di un report.The Built-in fields collection, which includes both the Globals and the User collections, represent global values provided by Reporting Services when a report is processed. La raccolta Globals fornisce valori come il nome del report, l'ora di inizio dell'elaborazione e i numeri di pagina correnti per l'intestazione o il piè di pagina.The Globals collection provides values such as the name of the report, the time when report processing began, and current page numbers for the report header or footer. La raccolta User fornisce le impostazioni relative a ID utente e lingua.The User collection provides the user identifier and language settings. Questi valori possono essere usati nelle espressioni per filtrare i risultati in un report.These values can be used in expressions to filter results in a report.

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.

Utilizzo della raccolta GlobalsUsing the Globals Collection

La raccolta Globals contiene le variabili globali per il report.The Globals collection contains the global variables for the report. Nell'area di progettazione, queste variabili sono precedute dal prefissata un & (e commerciale), ad esempio, [&ReportName].On the design surface, these variables appear prefixed by an & (ampersand), for example, [&ReportName]. Nella tabella seguente vengono descritti i membri della raccolta Globals .The following table describes the members of the Globals collection.

MembroMember TipoType DescriptionDescription
ExecutionTimeExecutionTime DateTimeDateTime Data e ora di inizio dell'esecuzione del report.The date and time that the report began to run.
PageNumberPageNumber Valore interoInteger Numero di pagina corrente relativo a interruzioni di pagina che ne determinano la reimpostazione.The current page number relative to page breaks that reset the page number. All'inizio dell'elaborazione del report, il valore è impostato su 1.At the beginning of report processing, the initial value is set to 1. Il numero di pagina aumenta per ogni pagina di cui è stato eseguito il rendering.The page number increments for each rendered page.

Per numerare le pagine all'interno di interruzioni di pagina per un rettangolo, un'area dati, un gruppo di aree dati o una mappa, nella proprietà PageBreak impostare la proprietà ResetPageNumber su True.To number pages within page breaks for a rectangle, a data region, a data region group, or a map, on the PageBreak property, set the ResetPageNumber property to True. Non supportato dai gruppi di gerarchie di colonna Tablix.Not supported on tablix column hierarchy groups.

La proprietà PageNumber può essere usata solo in espressioni presenti in un'intestazione o un piè di pagina.PageNumber can only be used in an expression in a page header or page footer.
ReportFolderReportFolder StringString Percorso completo della cartella contenente il report.The full path to the folder containing the report. Non include l'URL del server di report.This does not include the report server URL.
ReportNameReportName StringString Nome del report archiviato nel database del server di report.The name of the report as it is stored in the report server database.
ReportServerUrlReportServerUrl StringString URL del server di report in cui il report è in esecuzione.The URL of the report server on which the report is being run.
TotalPagesTotalPages Valore interoInteger Numero totale di pagine relativo alle interruzioni di pagina che determinano la reimpostazione di PageNumber.The total number of pages relative to page breaks that reset PageNumber. Se non sono impostate interruzioni di pagina, questo valore corrisponde a OverallTotalPages.If no page breaks are set, this value is the same as OverallTotalPages.

La proprietà TotalPages può essere usata solo in espressioni presenti in un'intestazione o un piè di pagina.TotalPages can only be used in an expression in a page header or page footer.
PageNamePageName StringString Nome della pagina.The name of the page. All'inizio dell'elaborazione del report, il valore viene impostato da una proprietà del report, InitialPageName.At the beginning of report processing, the initial value is set from InitialPageName, a report property. Quando ciascun elemento del report viene elaborato, questo valore viene sostituito con il valore corrispondente di PageName da un rettangolo, un'area dati, un gruppo di aree dati o una mappa.As each report item is processed, this value is replaced by the corresponding value of PageName from a rectangle, a data region, a data region group, or a map. Non supportato dai gruppi di gerarchie di colonna Tablix.Not supported on tablix column hierarchy groups.

La proprietà PageName può essere usata solo in espressioni presenti in un'intestazione o un piè di pagina.PageName can only be used in an expression in a page header or page footer.
OverallPageNumberOverallPageNumber Valore interoInteger Numero della pagina corrente per l'intero report.The page number of the current page for the entire report. ResetPageNumber non ha effetto su questo valore.This value is not affected by ResetPageNumber.

La proprietà OverallPageNumber può essere usata solo in espressioni presenti in un'intestazione o un piè di pagina.OverallPageNumber can only be used in an expression in a page header or page footer.
OverallTotalPagesOverallTotalPages Valore interoInteger Numero complessivo di pagine per l'intero report.The total number pages for the entire report. ResetPageNumber non ha effetto su questo valore.This value is not affected by ResetPageNumber.

La proprietà OverallTotalPages può essere usata solo in espressioni presenti in un'intestazione o un piè di pagina.OverallTotalPages can only be used in an expression in a page header or page footer.
RenderFormatRenderFormat RenderFormatRenderFormat Informazioni sulla richiesta di rendering corrente.Information about the current rendering request.

Per altre informazioni, vedere "RenderFormat" nella sezione successiva.For more information, see "RenderFormat" in the next section.

I membri della raccolta Globals restituiscono una variante.Members of the Globals collection return a variant. Se si desidera usare un membro di questa raccolta in un'espressione che richiede un tipo di dati specifico, è necessario eseguire dapprima il cast della variabile.If you want to use a member of this collection in an expression that requires a specific data type, you must first cast the variable. Per convertire, ad esempio, la variante relativa alla data e all'ora di esecuzione in un formato di data, usare =CDate(Globals!ExecutionTime).For example, to convert the execution time variant into a Date format, use =CDate(Globals!ExecutionTime). Per altre informazioni, vedere Tipi di dati nelle espressioni (Generatore report e SSRS).For more information, see Data Types in Expressions (Report Builder and SSRS).

RenderFormatRenderFormat

Nella tabella seguente vengono descritti i membri per RenderFormat.The following table describes the members for RenderFormat.

MembroMember TipoType DescriptionDescription
NomeName StringString Nome del renderer come registrato nel file di configurazione RSReportServer.The name of the renderer as registered in the RSReportServer configuration file.

Disponibile durante determinate parti del ciclo di elaborazione/rendering del report.Available during specific parts of the report processing/rendering cycle.
IsInteractiveIsInteractive BooleanBoolean Specifica se nella richiesta di rendering corrente è usato un formato di rendering interattivo.Whether the current rendering request uses an interactive rendering format.
DeviceInfoDeviceInfo Raccolta nome/valore di sola letturaRead-only name/value collection Coppie chiave/valore per i parametri deviceinfo per la richiesta di rendering corrente.Key/value pairs for deviceinfo parameters for the current rendering request.

È possibile specificare i valori stringa usando la chiave o un indice nella raccolta.String values can be specified by using either the key or an index into the collection.

EsempiExamples

Negli esempi seguenti viene illustrato come usare un riferimento alla raccolta Globals in un'espressione:The following examples show how to use a reference to the Globals collection in an expression:

  • L'espressione seguente, inserita in una casella di testo nel piè di pagina di un report, restituisce il numero di pagina e le pagine totali del report:This expression, placed in a text box in the footer of a report, provides the page number and total pages in the report:

    =Globals.PageNumber & " of " & Globals.TotalPages

  • Questa espressione restituisce il nome e l'ora di esecuzione del report.This expression provides the name of the report and the time it was run. Per la formattazione dell'ora viene usata la stringa di formattazione di MicrosoftMicrosoft .NET Framework.NET Framework per la data breve:The time is formatted with the MicrosoftMicrosoft .NET Framework.NET Framework formatting string for short date:

    =Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")

  • Con questa espressione, inserita nella finestra di dialogo Visibilità colonne per una colonna selezionata, viene visualizzata la colonna solo quando il report viene esportato in Excel.This expression, placed in the Column Visibility dialog box for a selected column, displays the column only when the report is exported to Excel. In caso contrario, è nascosta.Otherwise, the column is hidden.

    EXCELOPENXML si riferisce al formato di Excel incluso in Office 2007.EXCELOPENXML refers to the format of Excel that is included in Office 2007. EXCEL si fa riferimento al formato di Excel incluso in Office 2003.EXCEL refers to the format of Excel that is included in Office 2003.

    =IIF(Globals!RenderFormat.Name = "EXCELOPENXML" OR Globals!RenderFormat.Name = "EXCEL", false, true)

Utilizzo della raccolta UserUsing the User Collection

La raccolta User contiene i dati relativi all'utente che esegue il report.The User collection contains data about the user who is running the report. È possibile usare questa raccolta per filtrare i dati visualizzati in un report, per mostrare, ad esempio, solo quelli dell'utente corrente o visualizzare l'ID utente nel titolo del report.You can use this collection to filter the data that appears in a report, for example, showing only the data of the current user, or to display the UserID, for example, in a report title. Nell'area di progettazione, queste variabili sono precedute dal prefissata un & (e commerciale), ad esempio, [&UserID].On the design surface, these variables appear prefixed by an & (ampersand), for example, [&UserID].

Nella tabella seguente vengono descritti i membri della raccolta User .The following table describes the members of the User collection.

MembroMember TipoType DescriptionDescription
LinguaLanguage StringString Lingua dell'utente che esegue il report.The language of the user running the report. Ad esempio, en-US.For example, en-US.
UserIDUserID StringString ID dell'utente che esegue il report.The ID of the user running the report. Se si usa l'autenticazione di Windows, questo valore corrisponde all'account di dominio dell'utente corrente.If you are using Windows Authentication, this value is the domain account of the current user. Il valore è determinato dall'estensione di sicurezza di Reporting ServicesReporting Services , che può usare l'autenticazione di Windows o quella personalizzata.The value is determined by the Reporting ServicesReporting Services security extension, which can use Windows Authentication or custom authentication.

Per altre informazioni sul supporto di più lingue in un report, vedere "Considerazioni sulla progettazione di soluzioni per distribuzioni multilingue o globali" nella documentazione di Reporting ServicesReporting Services inclusa nella documentazione online di SQL Server.For more information about supporting multiple languages in a report, see "Solution Design Considerations for Multi-Lingual or Global Deployments" in the Reporting ServicesReporting Services documentation in SQL Server Books Online.

Utilizzo delle impostazioni localiUsing Locale Settings

È possibile usare espressioni per fare riferimento alle impostazioni locali in un computer client tramite il valore User.Language , in modo da determinare la modalità di visualizzazione di un report all'utente.You can use expressions to refer to the locale settings on a client computer through the User.Language value to determine how a report appears to the user. È possibile, ad esempio, creare un report in cui venga usata un'espressione di query diversa basata sul valore delle impostazioni locali.For example, you can create a report that uses a different query expression based on the locale value. La query può essere modificata per recuperare informazioni localizzate da una colonna diversa, a seconda della lingua restituita.The query may change to retrieve localized information from a different column depending on the language returned. È inoltre possibile usare un'espressione per modificare le impostazioni relative alla lingua del report o degli elementi del report in base a questa variabile.You can also use an expression in the language settings of the report or report items based on this variable.

Nota

Benché sia possibile modificare le impostazioni relative alla lingua di un report, è necessario assicurarsi che tale modifica non causi problemi di visualizzazione.While you can change the language settings of a report, you must be careful about any display issues this may cause. La modifica delle impostazioni locali del report potrebbe ad esempio comportare la modifica del formato della data nel report, ma anche la modifica del formato della valuta.For example, changing the locale setting of the report can change the date format in the report, but it can also change the currency format. A meno che non sia previsto un processo di conversione per la valuta, in questi casi è possibile che nel report venga visualizzato il simbolo di valuta errato.Unless there is a conversion process for the currency, this may cause the incorrect currency symbol to be displayed in the report. Per evitare tale problema, impostare le informazioni sulla lingua nei singoli elementi da modificare oppure impostare una lingua specifica per l'elemento contenente i dati relativi alla valuta.To avoid this, set the language information about the individual items that you want to change, or set the item with the currency data to a specific language.

Identificazione di UserID per i report relativi a snapshot o cronologiaIdentifying UserID for Snapshot or History Reports

Nei report che includono la variabile User!UserID è talvolta possibile che non vengano inclusi i dati specifici dell'utente che sta visualizzando il report.In some cases, reports that include the User!UserID variable will fail to show report data that is specific to the current user who is viewing the report.

Vedere ancheSee Also

Espressioni (Generatore report e SSRS) Expressions (Report Builder and SSRS)
Nella finestra di dialogo Espressione ( Generatore report ) Expression Dialog Box (Report Builder)
Tipi di dati in espressioni ( Generatore report e SSRS ) Data Types in Expressions (Report Builder and SSRS)
Formattazione di numeri e date ( Generatore report e SSRS ) Formatting Numbers and Dates (Report Builder and SSRS)
Esempi di espressioni ( Generatore report e SSRS )Expression Examples (Report Builder and SSRS)