式での組み込みコレクションの使用 (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 |
言語設定やユーザー ID など、レポートを実行しているユーザーに関するデータのコレクションを表します。常に使用可能です。 詳細については、「式での組み込みフィールド参照の使用 (Reporting Services)」を参照してください。 |
Parameters |
Parameters |
=Parameters("ReportMonth").Value または =Parameters!ReportYear.Value |
レポート パラメータのコレクションを表します。各パラメータには単一の値または複数の値を指定できます。初期化処理が完了するまで使用できません。詳細については、「式における Parameters コレクションの参照の使用 (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 |