Встроенные коллекции в выражениях в отчете с разбивкой на страницы (построитель отчетов)
Область применения:
Построитель отчетов (SSRS) Power BI конструктор отчетов построитель отчетов в SQL Server Data Tools
В выражение в отчете с разбивкой на страницы можно включить ссылки на следующие встроенные коллекции: ReportItems, Parameters, Fields, DataSets, DataSources, Variables и встроенные поля для общих сведений, таких как имя отчета. Не все коллекции отображаются в диалоговом окне выражения . Коллекции DataSets и DataSources доступны только во время выполнения для отчетов, опубликованных на сервере отчетов. Коллекция ReportItems является коллекцией текстовых полей в области отчета, например текстовых полей на странице или в верхнем колонтитуле.
Дополнительные сведения см. в разделе "Выражения" (построитель отчетов).
Примечание.
Создать и изменить определение для отчета на страницу (RDL-файл) можно с помощью построителя отчетов (Майкрософт), построителя отчетов Power BI и конструктора отчетов в SQL Server Data Tools.
Общие сведения о встроенных коллекциях
В следующей таблице перечислены встроенные коллекции, доступные при написании выражения. Каждая строка включает в себя программное имя с учетом регистра для коллекции. Имя есть, можно ли использовать диалоговое окно "Выражение" для интерактивного добавления ссылки на коллекцию, пример и описание, которое включает в себя, когда значения коллекции инициализированы и доступны для использования.
| Встроенная коллекция | Категория в диалоговом окне «Выражение» | Пример | Description |
|---|---|---|---|
| Глобальные переменные | Встроенные поля | =Globals.ReportName- or -=Globals.PageNumber |
Представляет глобальные переменные, полезные для отчетов, например для имени отчета или номера страницы. Доступна всегда. Дополнительные сведения см. в статьях о встроенных глобальных и пользовательских ссылках (построитель отчетов). |
| Пользователь | Встроенные поля | =User.UserID- или - =User.Language |
Представляет коллекцию сведений о пользователе, выполняющем отчет, например языковые настройки или идентификатор пользователя. Доступна всегда. Дополнительные сведения см. в статьях о встроенных глобальных и пользовательских ссылках (построитель отчетов). |
| Параметры | Параметры | =Parameters("ReportMonth").Value- или - =Parameters!ReportYear.Value |
Представляет коллекцию параметров отчета, каждый из которых может быть однозначным или многозначным. Недоступна до завершения обработки инициализации. Дополнительные сведения см. в статьях "Ссылки на коллекции параметров" (построитель отчетов). |
| Поля ( <набор> данных ) | Поля | =Fields!Sales.Value |
Представляет коллекцию полей набора данных, доступных для отчета. Доступна после получения данных из источника данных в набор данных. Дополнительные сведения см. в статьях о коллекциях полей набора данных (построитель отчетов). |
| Наборы данных | Не отображается | =DataSets("TopEmployees").CommandText |
Представляет коллекцию наборов данных, к которым выполняется обращение из тела определения отчета. Не включает источники данных, используемые только в верхних или нижних колонтитулах страниц. Недоступна в режиме локального предварительного просмотра. Дополнительные сведения см. в справочниках по коллекциям DataSources и dataSets (построитель отчетов). |
| Коллекция DataSources | Не отображается | =DataSources("AdventureWorks2022").Type |
Представляет коллекцию источников данных, к которым выполняется обращение из тела отчета. Не включает источники данных, которые используются только в верхних или нижних колонтитулах. Недоступна в режиме локального предварительного просмотра. Дополнительные сведения см. в справочниках по коллекциям DataSources и dataSets (построитель отчетов). |
| Переменные | Variables |
=Variables!CustomTimeStamp.Value |
Представляет коллекцию переменных отчета и групповых переменных. Дополнительные сведения см. в статьях о коллекциях переменных отчетов и групп (построитель отчетов). |
| ReportItems | Не отображается | =ReportItems("Textbox1").Value |
Представляет коллекцию текстовых полей для элемента отчета. Эта коллекция может использоваться для суммирования элементов на странице для включения в верхний или нижний колонтитул. Дополнительные сведения см. в справочниках по коллекции ReportItems (построитель отчетов). |
Использование в выражениях синтаксиса коллекций
Чтобы обратиться к коллекции из выражения, можно использовать стандартный синтаксис Microsoft Visual Basic для элемента в коллекции. В следующей таблице показаны примеры синтаксиса коллекций.
| Синтаксис | Пример |
|---|---|
| Collection!ObjectName.Property | =Fields!Sales.Value |
| Collection!ObjectName("Property") | =Fields!Sales("Value") |
| Collection("ObjectName").Property | =Fields("Sales").Value |
| Collection("Member") | =User("Language") |
| Collection.Member | =User.Language |