式で使用される組み込みコレクション (レポート ビルダーおよび SSRS)
レポート内の式には、ReportItems、Parameters、Fields、DataSets、DataSources、Variables などの組み込みコレクションへの参照とレポート名などのグローバル情報の組み込みフィールドへの参照を含めることができます。 [式] ダイアログ ボックスにすべてのコレクションが表示されるとは限りません。 DataSets コレクションと DataSources コレクションを使用できるのは、レポート サーバー上でパブリッシュされたレポートの実行時のみです。 ReportItems コレクションは、ページまたはページ ヘッダーのテキスト ボックスなど、レポート領域内のテキスト ボックスのコレクションです。
詳細については、「式 (レポート ビルダーおよび SSRS)」を参照してください。
Note
レポート定義 (.rdl) は、レポート ビルダーおよび SQL Server Data Tools のレポート デザイナーで作成および変更できます。 これらの作成環境では、レポートおよび関連アイテムの作成方法、開く方法、および保存方法が異なります。 詳細については、「microsoft.com の Web レポート デザイナー および レポート ビルダー (SSRS)でのレポートのデザイン」を参照してください。
組み込みコレクションについて
次の表は、式を記述するときに使用できる組み込みコレクションの一覧です。 各行に、プログラム上のコレクション名 (大文字と小文字は区別されます)、[式] ダイアログ ボックスを使用してコレクションへの参照を対話的に追加できるかどうか、使用例、および説明 (コレクションの値がいつ初期化され使用できるようになるかなど) を示します。
| 組み込みコレクション | [式] ダイアログ ボックスのカテゴリ | 例 | 説明 |
|---|---|---|---|
Globals |
組み込みフィールド | =Globals.ReportName- or -=Globals.PageNumber |
レポート名またはページ番号など、レポートで役立つグローバル変数を表します。 常に使用可能です。 詳細については、「組み込み Globals および Users 参照 (レポート ビルダーおよび SSRS)」をご覧ください。 |
User |
組み込みフィールド | =User.UserID- または - =User.Language |
言語設定やユーザー ID など、レポートを実行しているユーザーに関するデータのコレクションを表します。 常に使用可能です。 詳細については、「組み込み Globals および Users 参照 (レポート ビルダーおよび SSRS)」をご覧ください。 |
Parameters |
パラメーター | =Parameters("ReportMonth").Value- または - =Parameters!ReportYear.Value |
レポート パラメーターのコレクションを表します。各パラメーターには単一値または複数値を指定できます。 初期化処理が完了するまで使用できません。 詳細については、「Parameters コレクションの参照 (レポート ビルダーおよび SSRS)」を参照してください。 |
Fields(<データセット> ) |
フィールド | =Fields!Sales.Value |
レポートで使用可能なデータセットのフィールドのコレクションを表します。 データをデータ ソースからデータセットに取得した後で使用可能です。 詳細については、「データセット フィールド コレクションの参照 (レポート ビルダーおよび SSRS)」を参照してください。 |
DataSets |
表示されません | =DataSets("TopEmployees").CommandText |
レポート定義の本文から参照されるデータセットのコレクションを表します。 ページ ヘッダーまたはページ フッターでのみ使用されるデータ ソースは含まれません。 ローカル プレビューでは使用できません。 詳細については、「DataSources コレクションと DataSets コレクションの参照 (レポート ビルダーおよび SSRS)」を参照してください。 |
DataSources |
表示されません | =DataSources("AdventureWorks2012").Type |
レポートの本文内から参照されるデータ ソースのコレクションを表します。 ページ ヘッダーまたはページ フッターでのみ使用されるデータ ソースは含まれません。 ローカル プレビューでは使用できません。 詳細については、「DataSources コレクションと DataSets コレクションの参照 (レポート ビルダーおよび SSRS)」を参照してください。 |
Variables |
Variables |
=Variables!CustomTimeStamp.Value |
レポート変数とグループ変数のコレクションを表します。 詳細については、「レポート変数コレクションとグループ変数コレクションの参照 (レポート ビルダーおよび SSRS)」を参照してください。 |
ReportItems |
表示されません | =ReportItems("Textbox1").Value |
レポート アイテムのテキスト ボックスのコレクションを表します。 このコレクションは、ページ ヘッダーまたはページ フッターに含めるためにページ上のアイテムをまとめる場合に使用できます。 詳細については、「ReportItems コレクションの参照 (レポート ビルダーおよび SSRS)」を参照してください。 |
式でのコレクション構文の使用
式からコレクションを参照するには、コレクション内のアイテムに対して標準の 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 |