GrapeCity ActiveReports for .NET 16.0J
パラメータ付きのレポート
ActiveReportsユーザーガイド > サンプルとチュートリアル > チュートリアル > ページレポート/RDLレポートのチュートリアル > プレビュー > パラメータ付きのレポート

ActiveReportsでは、パラメータ付きのレポートを作成することができます。「All」オプションを選択し、すべてのデータを表示したり、複数の値を選択して多数のアイテムにデータを表示したりできるようになります。

このチュートリアルでは、複数のパラメータとすべてのデータを選択するオプションについて説明します。

このトピックでは、以下のタスクを行います。

メモ:

チュートリアルを完了すると、次のようなレポートが作成されます。

デザイン時のレイアウト

実行時のレイアウト

Visual StudioプロジェクトにActiveReportsを追加する

  1. Visual Studioで新規プロジェクトを開きます。
  2. [プロジェクト]メニューから[新しい項目の追加]を選択します。
  3. [新しい項目の追加]ダイアログで[ActiveReports 16.0J RDLレポート]を選択し、ファイル名をProductDetailsに変更します。
  4. [追加]ボタンをクリックします。

詳細については、「クイックスタート」を参照してくだざい。

レポートをデータソースに接続する

  1. レポートエクスプローラ]で、[データソース]ノードを右クリックして、[データソースの追加]オプションを選択するか、[追加](+)ボタンから[データソース]を選択します。
  2. [レポートデータソース]ダイアログ[全般]ページを選択し、名前を「ReportData」に変更します。
  3. このチュートリアルでは、Nwindデータベースに接続します。詳細については、「データソースとの接続」を参照してくだざい。

パラメータ付きのデータセットを作成する

  1. レポートエクスプローラ]で、[データソース]ノードを右クリックし、[データセットの追加]を選択するか、[追加](+)ボタンから[データセット]を選択します。
  2. [データセット]ダイアログで、[全般]ページを選択し、[名前]フィールドをDataSet1に変更します。この名前は[レポートエクスプローラ]で、[データソース]の子ノードとして表示されます。
  3. [データセット]ダイアログの[クエリ]フィールドに次のSQLクエリを入力します。
    SQLクエリ
    コードのコピー
    select distinct productName from Products
    
  4. クエリを検証するには、クエリボックスの横にある[データセットの検証]アイコンをクリックします。

  5. [OK]をクリックしてダイアログを閉じます。データセットとクエリフィールドは、レポートエクスプローラのノードとして表示されます。

レポートのパラメータを作成する

  1. レポートエクスプローラ]で、[パラメータ]ノードを選択します。
  2. ノードを右クリックし、[パラメータの追加]を選択して[レポート - パラメータ]ダイアログを開きます。
  3. 表示されるダイアログボックスで、[追加]ボタンをクリックしてリストに新しいパラメータを追加します。
  4. 以下のプロパティを設定します。

    [全般]タブ

    • 名前: ReportParameter1
    • データ型: String
    • パラメータ入力ダイアログに表示する文字列:製品名を選択してください。
    • リストから一つ以上の製品名を選択するには[複数の値を許可]の横にあるチェックボックスを選択します。
    • "すべて選択"を選択した時の値(未指定の場合、すべての値が指定されます):1

    [使用できる値]タブでは、クエリを選択します。

    • データセット: DataSet1
    • 値: productName
    • ラベル: productName
      メモ: パラメータの名前は、対象レポートのパラメータの名前と一致させる必要があります。パラメータでは、スペルミス、大文字/小文字の違い、または、無効なパラメータが指定されている場合には、レポートは正しく動作しません。レポートからリストにある値の列にパラメータを渡すことができます。リンクしたレポートでパラメータに対して不適切な値を指定するか、パラメータの名前が一致しない場合、リンクしたレポートは実行されません。
  5. [OK]をクリックしてダイアログを閉じ、コレクションにパラメータを追加します。この名前は[レポートエクスプローラ]で、パラメータの子ノードとして表示されます。

パラメータ値のためにデータセットを追加する

  1. レポートエクスプローラ]で[データソース]ノードを右クリックし、[データセットの追加]を選択するか、[追加](+)ボタンから[データセット]を選択します。
  2. [データセット]ダイアログ[全般]ページを選択してデータセットの[名前]フィールドをDataSet2に変更します。この名前は[レポートエクスプローラ]で、[データソース]の子ノードとして表示されます。
  3. [パラメータ]ページの[名前]オプションに[ReportParameter1]と入力します。
  4. [値]=Parameters!ReportParameter1.Value」と入力します。
  5. [パラメータ]ページの[名前]オプションに[Parameter1]と入力します。
  6. [値]=Parameters!ReportParameter1.Value」と入力します。
  7. [データセット]ダイアログの[クエリ]フィールドに次のSQLクエリを入力します。
    SQLクエリ
    コードのコピー
    select * from products where ProductName in (?) OR '1' in (?)
    
  8. クエリを検証するには、クエリボックスの横にある[データセットの検証]アイコンをクリックします。
  9. [OK]をクリックしてダイアログを閉じます。データセットとクエリフィールドは、レポートエクスプローラのノードとして表示されます。

レポートのレイアウトを作成する

  1. ツールボックスからデザナ面上にTableデータ領域をドラッグし、[プロパティ]ウィンドウで次のプロパティを設定します。
    プロパティ名 プロパティの値
    Location 0.5in, 0.25in
    DataSetName DataSet2
    Size 4.8in, 0.75in
  2. レポートエクスプローラ]でDataSet2]データセットから以下のフィールドをテーブルの詳細行にドラッグし、次のテーブルのようにプロパティを設定します。
    フィールド
    ProductName TableColumn1 2.37in
    UnitPrice TableColumn2 0.67in
    UnitsOnOrder TableColumn3 1.62in
  3. フィールド名を含む静的なラベルは、テーブルヘッダー行に自動的に作成されます。外観を向上するには、テーブルヘッダー行を選択して、「BackgroundColor」プロパティを「DeepSkyBlue」に設定します。

レポートを表示する

または、

関連トピック