C# DataGridViewに列を手動で追加する

このサイトはプロモーションを含みます

2024年9月8日

Windowsフォームアプリケーションを開発していると、データを表形式で表示するためにDataGridViewを使用することがよくあります。特に、動的にデータを表示する場合や、特定の形式でデータを表示したい場合には、DataGridViewに列を手動で追加する必要があります。この記事では、C#でDataGridViewに列を手動で追加する方法を、初心者の方にも分かりやすく解説します。

基本的な列の追加方法

DataGridViewに列を追加する最も基本的な方法は、Columns.Add()メソッドを使用することです。以下に、文字列型の列を追加する簡単な例を示します。

using System;
using System.Windows.Forms;

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

    private void AddColumnsToDataGridView()
    {
        // 文字列型の列を追加
        dataGridView1.Columns.Add("Name", "名前");
        dataGridView1.Columns.Add("Email", "メールアドレス");

        // 列幅の自動調整を有効にする
        dataGridView1.AutoSizeColumnsMode = DataGridViewAutoSizeColumnsMode.Fill;
    }
}

このコードでは、「名前」と「メールアドレス」という2つの文字列型の列を追加しています。AutoSizeColumnsModeプロパティを設定することで、列幅が自動的に調整されるようになります。

様々な型の列を追加する

DataGridViewでは、文字列以外の型の列も追加することができます。以下に、異なる型の列を追加する例を示します。

private void AddVariousColumnsToDataGridView()
{
    // 文字列型の列
    dataGridView1.Columns.Add("Name", "名前");

    // 整数型の列
    DataGridViewColumn ageColumn = new DataGridViewTextBoxColumn();
    ageColumn.Name = "Age";
    ageColumn.HeaderText = "年齢";
    ageColumn.ValueType = typeof(int);
    dataGridView1.Columns.Add(ageColumn);

    // 日付型の列
    DataGridViewColumn birthDateColumn = new DataGridViewTextBoxColumn();
    birthDateColumn.Name = "BirthDate";
    birthDateColumn.HeaderText = "生年月日";
    birthDateColumn.ValueType = typeof(DateTime);
    dataGridView1.Columns.Add(birthDateColumn);

    // チェックボックス列
    DataGridViewCheckBoxColumn activeColumn = new DataGridViewCheckBoxColumn();
    activeColumn.Name = "IsActive";
    activeColumn.HeaderText = "アクティブ";
    dataGridView1.Columns.Add(activeColumn);
}

この例では、文字列型、整数型、日付型、そしてチェックボックス型の列を追加しています。それぞれの列の型に応じて、適切なDataGridViewColumnのサブクラスを使用しています。

列のプロパティをカスタマイズする

列を追加した後、その列のプロパティを設定してカスタマイズすることができます。以下に、いくつかの一般的なカスタマイズの例を示します。

private void CustomizeColumns()
{
    // 名前列の幅を固定
    dataGridView1.Columns["Name"].Width = 150;

    // 年齢列を読み取り専用に設定
    dataGridView1.Columns["Age"].ReadOnly = true;

    // 生年月日列の表示形式を設定
    DataGridViewColumn birthDateColumn = dataGridView1.Columns["BirthDate"];
    birthDateColumn.DefaultCellStyle.Format = "yyyy年MM月dd日";

    // アクティブ列のヘッダーテキストを中央揃えに
    dataGridView1.Columns["IsActive"].HeaderCell.Style.Alignment = DataGridViewContentAlignment.MiddleCenter;
}

このコードでは、列の幅の固定、読み取り専用の設定、日付の表示形式の指定、ヘッダーテキストの配置など、様々なカスタマイズを行っています。