式で使用される組み込みコレクション (レポート ビルダーおよび SSRS)

レポート内の式には、ReportItems、Parameters、Fields、DataSets、DataSources、Variables などの組み込みコレクションへの参照とレポート名などのグローバル情報の組み込みフィールドへの参照を含めることができます。 [式] ダイアログ ボックスにすべてのコレクションが表示されるとは限りません。 DataSets コレクションと DataSources コレクションを使用できるのは、レポート サーバー上でパブリッシュされたレポートの実行時のみです。 ReportItems コレクションは、ページまたはページ ヘッダーのテキスト ボックスなど、レポート領域内のテキスト ボックスのコレクションです。

詳細については、「式 (レポート ビルダーおよび SSRS)」を参照してください。

注
SQL Server データ ツールのレポート ビルダーまたはレポート デザイナーを使用して、レポート定義 (.rdl) を作成および変更できます。これらの作成環境では、レポートおよび関連アイテムの作成方法、開く方法、および保存方法が異なります。詳細については、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(<Dataset>)	フィールド	=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

関連項目

タスク

式の追加 (レポート ビルダーおよび SSRS)

参照

式の例 (レポート ビルダーおよび SSRS)