Поделиться через

  • Статья

Применение встроенных коллекций в выражениях (службы Reporting Services)

Службы Reporting Services предоставляют следующие встроенные коллекции, на которые можно ссылаться в выражениях: ReportItems, Parameters, Fields, DataSets, DataSources, Variables и встроенные поля для общих сведений, таких как имя отчета. В диалоговом окне Выражения отображаются не все коллекции. Коллекции DataSets и DataSources доступны только во время выполнения для отчетов, опубликованных на сервере отчетов. Коллекция ReportItems является коллекцией текстовых полей в области отчета, например текстовых полей на странице или в верхнем колонтитуле.

Дополнительные сведения см. в разделе Основные сведения о ссылках в выражениях (службы Reporting Services).

Основные сведения о встроенных коллекциях

В следующей таблице перечислены встроенные коллекции, доступные из служб Reporting Services. Каждая строка включает программное имя коллекции с учетом регистра, признак, можно ли использовать диалоговое окно «Выражение» для интерактивного добавления в коллекцию ссылки, пример и описание, включающее сведения о том, когда инициализируются и становятся доступными для использования значения коллекции.

Встроенная коллекция

Категория в диалоговом окне «Выражение»

Пример

Описание

Globals

Встроенные поля

=Globals.ReportName

- or -

=Globals.PageNumber

Представляет глобальные переменные, полезные для отчетов, например для имени отчета или номера страницы. Доступна всегда.

Дополнительные сведения см. в разделе Использование в выражениях ссылок на встроенные поля (службы Reporting Services).

User

Встроенные поля

=User.UserID

или

=User.Language

Представляет коллекцию сведений о пользователе, выполняющем отчет, например языковые настройки или идентификатор пользователя. Доступна всегда.

Дополнительные сведения см. в разделе Использование в выражениях ссылок на встроенные поля (службы Reporting Services).

Parameters

Parameters

=Parameters("ReportMonth").Value

или

=Parameters!ReportYear.Value

Представляет коллекцию параметров отчета, каждый из которых может быть однозначным или многозначным. Недоступна до завершения обработки инициализации. Дополнительные сведения см. в разделе Использование в выражениях ссылок на коллекцию параметров (службы Reporting Services).

Fields(<Dataset>)

Fields

=Fields!Sales.Value

Представляет коллекцию полей набора данных, доступных для отчета. Доступна после получения данных из источника данных в набор данных. Дополнительные сведения см. в разделе Использование в выражениях ссылок на коллекцию полей набора данных (службы Reporting Services).

DataSets

Не отображается

=DataSets("TopEmployees").CommandText

Представляет коллекцию наборов данных, к которым выполняется обращение из тела определения отчета. Не включает источники данных, которые используются только в верхних или нижних колонтитулах. Недоступна в режиме локального предварительного просмотра. Дополнительные сведения см. в разделе Использование ссылок коллекций DataSources и DataSets в выражениях (службы Reporting Services).

DataSources

Не отображается

=DataSources("AdventureWorks").Type

Представляет коллекцию источников данных, к которым выполняется обращение из тела отчета. Не включает источники данных, которые используются только в верхних или нижних колонтитулах. Недоступна в режиме локального предварительного просмотра. Дополнительные сведения см. в разделе Использование ссылок коллекций DataSources и DataSets в выражениях (службы Reporting Services).

Variables

Variables

=Variables!CustomTimeStamp.Value

Представляет коллекцию переменных отчета и групповых переменных. Дополнительные сведения см. в разделе Использование ссылок на коллекции переменных отчета и групповых переменных в выражениях (службы Reporting Services).

ReportItems

Не отображается

=ReportItems("Textbox1").Value

Представляет коллекцию текстовых полей для элемента отчета. Эта коллекция может использоваться для суммирования элементов на странице для включения в верхний или нижний колонтитул. Дополнительные сведения см. в разделе Использование в выражениях ссылок на коллекцию ReportItems (службы Reporting Services).

Использование в выражениях синтаксиса коллекций

Чтобы обратиться к коллекции из выражения, можно использовать стандартный синтаксис MicrosoftVisual 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