チュートリアル : ローカル処理モードでのビジネスオブジェクトデータソースと ReportViewer Windows フォームコントロールの使用

[アーティクル]
09/17/2008

このチュートリアルでは、Microsoft Visual Studio 2008 Windows アプリケーションのレポートでビジネスオブジェクトを使用してオブジェクトデータソースを使用する方法について説明します。ビジネスオブジェクトとオブジェクトデータソースの詳細については、「ビジネスオブジェクトへのバインディング」を参照してください。

Visual Studio Windows アプリケーションプロジェクトにレポートを追加するには、次の手順を実行します。この例では、Microsoft Visual C# でアプリケーションを作成します。

新しい Windows アプリケーションプロジェクトの作成

[ファイル] メニューの [新規作成] をポイントし、[プロジェクト] をクリックします。
[新しいプロジェクト] ダイアログボックスの [Visual C#] で、Windows アプリケーションテンプレートを選択します。
プロジェクト名として「BusinessObject」と入力し、[OK] をクリックします。

データソースとして使用するビジネスオブジェクトの作成

[プロジェクト] メニューの [新しい項目の追加] をクリックします。
[新しい項目の追加] ダイアログボックスで [クラス] を選択し、ファイル名として「BusinessObjects.cs」と入力して、[追加] をクリックします。新しいファイルがプロジェクトに追加され、Visual Studio で自動的に開きます。

BusinessObjects.cs の既定のコードを、次のコードに置換します。

using System;
using System.Collections.Generic;

// Define the Business Object "Product" with two public properties
//    of simple datatypes.
public class Product {
    private string m_name;
    private int m_price;

    public Product(string name, int price) {
        m_name = name;
        m_price = price;
    }

    public string Name {
        get {
            return m_name;
        }
    }

    public int Price {
        get {
            return m_price;
        }
    }
}

// Define Business Object "Merchant" that provides a 
//    GetProducts method that returns a collection of 
//    Product objects.

public class Merchant {
    private List<Product> m_products;

    public Merchant() {
        m_products = new List<Product>();
        m_products.Add(new Product("Pen", 25));
        m_products.Add(new Product("Pencil", 30));
        m_products.Add(new Product("Notebook", 15));
    }

    public List<Product> GetProducts() {
        return m_products;
    }
}

[プロジェクト] メニューの [ソリューションのビルド] をクリックします。これにより、オブジェクトのアセンブリが作成され、レポートのデータソースとして後で使用できるようになります。

プロジェクトへのレポートの追加

プロジェクトまたはプロジェクト項目がソリューションエクスプローラで選択されていることを確認します。
[プロジェクト] メニューの [新しい項目の追加] をクリックします。
[新しい項目の追加] ダイアログボックスで [レポート] をクリックします。レポート名を入力して、[追加] をクリックします。レポートがプロジェクトに追加され、レポートデザイナで自動的に開きます。レポート名は、既定で Report1.rdlc になります。

データソース構成ウィザードを使用したデータソースの作成

プロジェクトまたはプロジェクト項目がソリューションエクスプローラで選択されていることを確認します。
[データ] メニューの [新しいデータソースの追加] をクリックします。これにより、データソース構成ウィザードが起動します。
[データソースの種類を選択] ページで、[オブジェクト] を選択して [次へ] をクリックします。
データソース構成ウィザードに、プロジェクトの既存のクラスが一覧表示されます。一覧に [Product] が表示されるまで [BusinessObjects] のクラス階層を展開します。[Product] を選択して [次へ] をクリックし、[完了] をクリックします。

ウィザードが閉じると、新しいデータソースオブジェクトが [データソース] ウィンドウに表示されます。

レポートのデザイン

レポートをデザインモードで開いた状態で、ツールボックスを開きます。ツールボックスから、テーブル コントロールをレポートにドラッグします。レポートのデザインビューウィンドウにテーブルコントロールが表示されます。点線の背景はレポート本文の寸法を表し、テーブルコントロールのサイズと位置は変更することができます。
[データソース] ウィンドウから、[Product] データソースの [Name] フィールドをテーブルの詳細行の最初の列にドラッグします。詳細行は中央の行です。詳細行を指定すると、ヘッダー行が自動的に入力されます。

[!メモ]

[データソース] ウィンドウが表示されていない場合は、[データ] メニューの [データソースの表示] をクリックします。
[Price] フィールドを 2 列目の詳細行にドラッグして、[Name] フィールドの横になるようにします。必要に応じて、左側のテーブルヘッダーアイコンをクリックしてテーブルのヘッダー行を選択し、太字フォントスタイルを適用します。
使用されていない 3 番目の列を削除します。3 番目の列をクリックして、ヘッダーバーをクリックし、Del キーを押します。
レポートにタイトルを追加するには、ツールボックスを開いて、テキストボックス コントロールをレポートにドラッグします。テキストボックスをテーブルの上部に配置します。レポート名として「Products」と入力します。
(省略可) フォントサイズとフォントスタイルをテキストに適用して、タイトルが目立つようにします。

レポートへの ReportViewer コントロールの追加

自動的に生成された Windows アプリケーションフォームをデザインビューで選択します。フォーム名は、既定で Form1.cs になっています。
ツールボックスを開きます。ツールボックスで [データ] ノードを展開し、[ReportViewer] アイコンをフォームにドラッグします。フォームを展開し、必要に応じて ReportViewer の位置を変更します。
ReportViewer コントロールを選択し、右上隅の三角形をクリックして、スマートタグパネルを開きます。[レポートの選択] ドロップダウンリストをクリックし、デザインしたレポートを選択します。レポート名は、既定で Report1.rdlc になっています。レポートで使用されている各オブジェクトデータソースに対応して、BindingSource が自動的に作成されます。

BindingSource オブジェクトへのデータソースインスタンスの指定

Visual Studio フォームを右クリックして、ショートカットメニューから [コードの表示] をクリックします。
Form1.cs で、クラスの先頭に次のコードを追加します。public partial class Form1 : Form { ステートメントの後、コンストラクタの前で最初の行を使用できます。
```
// Instantiate the Merchant class.
private Merchant m_merchant = new Merchant();
```
Form1_Load() メソッドで、RefreshReport 呼び出しの前に、最初の行として次のコードを追加します。
```
// Bind the Product collection to the DataSource.
this.ProductBindingSource.DataSource = m_merchant.GetProducts();
```

アプリケーションの実行

F5 キーを押してアプリケーションを実行し、レポートを表示します。

参照

チュートリアル : ローカル処理モードでのビジネス オブジェクト データ ソースと ReportViewer Windows フォーム コントロールの使用

新しい Windows アプリケーション プロジェクトの作成

データ ソースとして使用するビジネス オブジェクトの作成