Active Reportsなど有償製品は高機能だけど高価。とはいえ、PrintDocumentをゴリゴリ書くのは結構大変ですよね。なにかいい方法ないかな・・・と探していた時に偶然見つけたのがMicrosoft Report（ReportViewer）。マイクロソフト謹製なのでVisual Studioとの相性も良さそう！と思ったのですが、意外に欲しい情報を見つけるのに苦労したので覚書として記します。

作業環境

Windows 11 Pro＋Visual Studio 2019 Community（C#.NET）です。

下準備1

マイクロソフト謹製なのですが、素のVisual Studioでは使えません。拡張機能の管理を選択し「オンライン」のタブをクリックしたら「Microsoft Rdlc Report Designer for Visual Studio」を検索→インストールします。

ウィザードに従うだけですので以後省略。

下準備2

WindowsFormアプリケーションで新たにプロジェクトを作成します（.NETのバージョンは4.8を選択しました）。続いてツール→NuGetパッケージマネージャーから「Microsoft.ReportingServices.ReportViewerControl.Winforms」を検索します。

こちらをインストールします。

大雑把な流れ

Form2とReport1を追加。Form1にはボタンを1つ設置し、このボタンをクリックしたらレポート（Form2）が表示されるような仕掛けにします。

Form1の内容

Button1_ClickでForm2を表示させます。

namespace sandambara
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        private void button1_Click(object sender, EventArgs e)
        {
            Form2 form2 = new Form2();
            form2.Show();
        }
    }
}

Form2の内容

実際にレポートを表示させる部分（ReportViewer）をFormに設置します。

レポートを作成したことの無い方には伝わりにくいかもですが、Formが土台、その上にViewerがのっかっていて、その中にレポートが表示されるイメージです。テレビに例えるとFormが本体外枠、Viewerが画面、Reportが映像・・・と例えれば伝わるでしょうか？

設置したら「親コンテナーにドッキングする」をクリックするとFormいっぱいにViewerが広がってくれます。Choose Reportはプロジェクトに追加しておいたReport1.rdlcを指定しておきましょう。

このときのコードはこんな感じです。

namespace sandambara
{
    public partial class Form2 : Form
    {
        public Form2()
        {
            InitializeComponent();
        }

        private void Form2_Load(object sender, EventArgs e)
        {
            this.reportViewer1.RefreshReport();
        }

    }
}

レポートの準備

データセットを使ったレポートの作り方はたくさん見つけられるので、今回はレポート生成時に値を渡して表示させることをゴールとします。

まず、ソリューションエクスプローラーでReport1.rdlcを選択し、プロパティの「出力ディレクトリにコピー」を「常にコピー」へ変更します。

今Visual Studioの画面はこんな風になっていると思います。

今回はここへ３つの文字列を表示させます。

画面左側の「レポートデータ」の「新規」をクリック→パラメータを指定します。

こんな画面が表示されますので、そのままOKをクリックします。これをあと２回繰り返してReportParameter1とReportParameter2、ReportParameter3を作成しましょう。

つぎに、受け取ったパラメータを表示するテキストボックスを配置します。

テキストボックスのフォントはArialがデフォルトになっています。日本語を表示できるよう何か適当なフォント（ＭＳ Ｐゴシックなど）に変更しておきましょう。

次に、先ほど作成したReportParameter1-3をそれぞれテキストボックスへドラッグアンドドロップします。

以上でレポートの準備が整いました。続いてForm2（ReportViewer側）を仕上げます。

先人に感謝を捧げましょう

今回やりたいことがなかなか実現できずググり続けて数日。ここがなかったら折れていたと思います。多謝！ReportViewerコントロール|Aoplanning

Form2にレポートへ渡すパラメータをセットする

Form2.csへusingを追加します。

using Microsoft.Reporting.WinForms;

続いてForm2_Loadをモディファイします。

private void Form2_Load(object sender, EventArgs e)
{
    // レポートへ渡す文字列
    string _param1 = string.Empty;
    string _param2 = string.Empty;
    string _param3 = string.Empty;

    // ここにDBから値を取ってくる処理

    // DBからとってきた文字列を変数へ格納
    _param1 = "ほしいものリスト";
    _param2 = "生ビール";
    _param3 = "焼肉";

    // レポートファイル指定
    // Report1.rdlxのプロパティ→完全パスを参照
    reportViewer1.LocalReport.ReportPath = @"C:\Users\sandambara\source\repos\sandambara\sandambara\Report1.rdlc";
    
    // レポートファイルに渡すパラメーター
    ReportParameter[] rpt = new ReportParameter[3];

    // パラメータ値セット
    rpt[0] = new ReportParameter("ReportParameter1", _param1);
    rpt[1] = new ReportParameter("ReportParameter2", _param2);
    rpt[2] = new ReportParameter("ReportParameter3", _param3);

    try
    {
        // パラメータ適用
        reportViewer1.LocalReport.SetParameters(rpt);
    }
    catch (Exception ex)
    {
        // レポートファイルが見つからないとここでエラーになります。
        MessageBox.Show(ex.Message.ToString(), "エラー", MessageBoxButtons.OK, MessageBoxIcon.Error);
        this.Dispose();
        return;
    }

    // プレビュー表示
    reportViewer1.SetDisplayMode(DisplayMode.PrintLayout);

    reportViewer1.RefreshReport();
}

さあ、実行してみましょう！

まとめ

全部終わってからCrystal Reportsの存在を思い出してブルーになりました。

先人に感謝

こちらを参考にさせて頂きました。良記事に感謝です！

DataGridViewをDataTableに変換 C# | 文系出身のSEですが、何か (loosecarrot.com)

地道にやるしかなかった

1セルずつ地道にやります。

DataTable dt = new DataTable();

// i：DataGridViewの列番号　j：DataGridViewの行番号
int i, j;

// DataTableに列を作ります
for(i=0; i<DataGridView1.ColumnCount; i++)
{
    dt.Columns.Add(DataGridView1.Columns[i].HeaderText);
}

// 行数分繰り返し
for(j=0; j<DataGridView1.Rows.Count; j++)
{
    // DataTableの行作成
    DataRow dataRow = dt.NewRow();

    // 列数分繰り返し
    for (i = 0; i < DataGridView1.Columns.Count; i++)
    {
        // j + 1 行目の i + 1 列列目をDataTableに投入
        dataRow[i] = DataGridView1.Rows[j].Cells[i].Value;
    }

    // 行追加
    dt.Rows.InsertAt(dataRow, j);
}

まとめ

クリップボードの内容をペーストするのなんかもそうですが、DataGridViewまわりの処理は需要ありそうなのに自分で実装するしかないのが残念なところです。

列作成

まずはDataGridViewの列を作成します。

// Form_Loadあたりに
// ごく簡素な名簿みたいなもの

// DataGridViewの列数
DataGridView1.ColumnCount = 4;

DataGridView1.Columns[0].HeaderText = "項番";
DataGridView1.Columns[1].HeaderText = "苗字";
DataGridView1.Columns[2].HeaderText = "名前";
DataGridView1.Columns[3].HeaderText = "年齢";

DataGridView1.Columns[0].Width = 60;
DataGridView1.Columns[1].Width = 150;
DataGridView1.Columns[2].Width = 150;
DataGridView1.Columns[3].Width = 60;

DataGridView1.Columns[0].DefaultCellStyle.Alignment = DataGridViewContentAlignment.MiddleRight;
DataGridView1.Columns[1].DefaultCellStyle.Alignment = DataGridViewContentAlignment.MiddleLeft;
DataGridView1.Columns[2].DefaultCellStyle.Alignment = DataGridViewContentAlignment.MiddleLeft;
DataGridView1.Columns[3].DefaultCellStyle.Alignment = DataGridViewContentAlignment.MiddleRight;

名簿ならフリガナ要るだろうとか、その辺はサンプルということで。

入力フォーム

項番、苗字、名前、年齢それぞれ入力用にTextBoxを用意しておきます。項番に数値nが入力されていたらDataGridViewのn行目のデータをTextBoxに呼び出して編集、入力されていなければ新規登録のイメージです。

登録ボタンを押したとき

ボタンのClickイベントへこんな感じで。入力値のチェックは先に済ませておきましょう。

// DataGridViewの何行目か
int i;

if (項番のTextBox.Text == string.Empty)
{
    // 新規登録
    DataGridView1.Rows.Add();
    i = DataGridView1.Rows.Count - 1;
}
else
{
    // 既存データの変更
    i = int.Parse(項番のTextBox.Text) - 1;
}

DataGridView1.Rows[i].Cells[0].Value = i + 1;
DataGridView1.Rows[i].Cells[1].Value = 苗字のTextBox.Text;
DataGridView1.Rows[i].Cells[2].Value = 名前のTextBox.Text;
DataGridView1.Rows[i].Cells[3].Value = int.Parse(年齢のTextBox.Text);

// 入力値クリア
項番のTextBox.Text = string.Empty;
苗字のTextBox.Text = string.Empty;
名前のTextBox.Text = string.Empty;
年齢のTextBox.Text = string.Empty;

// DataGridViewの行を非選択
DataGridView1.CurrentCell = null;

まとめ

いつも忘れるおバカな自分へ助け舟として。