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