レポート (Visual Studio レポート デザイナ) で表現のグローバル コレクション
ReportViewer コントロールで処理されるレポート定義について記述する式はグローバル オブジェクトのコレクションへの参照を含めることができます。使用できる 5 つのグローバル オブジェクトのコレクションが: フィールド 、 Globals 、 パラメータ 、 ReportItems 、および ユーザー です。これらのコレクションにアクセスするには標準の Visual Basic コレクション構文を使用できます。この構文の例は次のとおりです。
コレクション ! ObjectName
=User!Language
Collection.Item (以下" ObjectName ")
=User.Item("Language")
コレクション (以下" ObjectName ")
=User("Language")
プロパティの構文を使用して Globals および ユーザー コレクションの項目にアクセスすることができますも。この例のとおりです。
コレクション です。 ObjectName
=Globals.PageNumber
Globals および Users コレクションのメンバはバリエーションを返します。特定のデータ型を要求する式でグローバル変数を使用する場合は、変数にキャスト最初する必要があります。たとえば、CDate(Globals!ExecutionTime)
.
フィールド
Fields コレクションには、現在のデータ ソース内でフィールドが含まれています。フィールドは通常、レポート内のテキスト ボックスにデータを表示を他のレポート アイテム、プロパティ、および関数でも使用するあります。 Fields コレクション内のアイテムは 2 つのプロパティ 値 および IsMissing があります。 Value プロパティは、データ ソースのフィールドの取得した値を返します。 IsMissing プロパティは、フィールドが、データ ソースに存在するかどうかを示します。これはクエリのフィールドの変数セットを返すに便利です。足りないフィールドには、 Value プロパティは Null です。
フィールド オブジェクトにアクセスする最も一般的な構文はプロパティの構文、たとえば、 フィールド です! Product.Value 。上記で説明した、コレクションの構文を使用することができますも。一部のデータ ソースをフィールドに追加のプロパティを入力します。これらのプロパティ、コレクションの構文を使用してアクセスできます。データ ソースは、プロパティをサポートしていませんまたは、クエリが実行されると、フィールドが見つからないは、プロパティの値が Null 値 (String) の値 の種類のプロパティの オブジェクト 、および 整数型 (Integer) の値 の種類のプロパティに 0 です。
レポートはレポートにデータ ソースごとの仮想の Fields コレクションを 1 があります。フィールドする必要があります、コレクション内で一意が、同じのフィールド名は複数のコレクションに存在します。データ領域内のフィールドを参照するとき、データ テーブルまたはビジネス オブジェクト、データ領域コレクションは使用決定します。集計式内のフィールドを参照するとき、範囲のデータ ソースは使用するコレクション判断します。
Globals
Globals コレクションには、レポートのグローバル変数が含まれます。次の表は、 Globals コレクションのメンバです。
メンバ | 種類 | 説明 |
---|---|---|
ExecutionTime |
DateTime |
日付と時刻を実行するレポートを開始します。 |
PageNumber |
整数 |
現在のページ数です。ページのヘッダーおよびフッターでのみ使用できます。 |
ReportFolder |
文字列 |
レポートを含むフォルダへ完全パスです。これには、レポート サーバーの URL は含まれません。このメンバは、サーバーのレポートにのみ適用されます。 |
ReportName |
文字列 |
レポートの名前は、レポート サーバー データベースに格納されます。このメンバは、サーバーのレポートにのみ適用されます。 |
ReportServerUrl |
文字列 |
レポートが実行されているレポート サーバーの URL。このメンバは、サーバーのレポートにのみ適用されます。 |
TotalPages |
整数 |
レポートのページの総数です。ページのヘッダーおよびフッターでのみ使用できます。 |
グローバル変数の例は次のとおりです。
この式をレポートのフッターのテキスト ボックスに配置されたページ番号およびレポートに合計ページを示します。
=Globals.PageNumber & " of " & Globals.TotalPages
この式は、レポートとが実行された時間の名前を提供します。時間が短い形式の日付の文字列を書式、.NET Framework でフォーマットされています。
=Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")
パラメータ
Parameters コレクションには、レポート内のレポート パラメータが含まれます。フィルタまたは他の関数のパラメータに基づいてレポート外観を変更するパラメータを使用できます。 Parameters コレクション内のアイテムは 2 つのプロパティ 値 および Label があります。 Value プロパティはパラメータには、たとえば、社員コード値を返します。 Label プロパティは、ユーザー フレンドリなラベル パラメータには、たとえば、EmployeeName を返します。ラベルが指定されていない場合、 Label プロパティの値が、 Value プロパティと同じです。1 つ以上のラベルが同じ値に関連付けられている場合は、最初の一致するラベルを使用します。パラメータは、プロパティの構文または、コレクションの構文のいずれかを使用アクセスできます。
ReportItems
ReportItems コレクションは、レポート内のテキスト ボックスが含まれます。 ReportItems コレクション内のアイテムが 1 つのみのプロパティをある: 値 。 ReportItems アイテムの値を表示またはレポートの別のフィールドからデータを計算できます。アクセスする、現在のテキスト ボックスの値を使用 Me.Value または 値 だけです。 Me.Value と Value は、集計関数内使用できません。すべての構文を使用してこれらの関数のいずれかでのテキスト ボックスの値にアクセスをします。
レポート アイテム数式の例のとおりです。
この式をテキスト ボックスに配置されたは Textbox1 という名前のテキスト ボックスの値を表示します。
=ReportItems!Textbox1.Value
ユーザー
ユーザー コレクションには、レポートを実行しているユーザーのデータが含まれます。次の表は、 ユーザー コレクションのメンバです。
メンバ | 種類 | 説明 |
---|---|---|
言語 |
文字列 |
レポートを実行するユーザーの言語 ID です。 |
ユーザー ID |
文字列 |
レポートを実行するユーザーの ID です。 |
項目を参照してください。
概念
ReportViewer コントロール (Visual Studio)
レポート (Visual Studio レポート デザイナ) で式を使用してください。
レポート (Visual Studio レポート デザイナ) でレポートのパラメータを定義します。
ページ ヘッダーおよびページ フッター レポート (Visual Studio レポート デザイナ) を追加
リモート処理を ReportViewer を構成します。