ErrorProvider

[C#] DataGridViewのセルでErrorProviderを使用する方法

2025-01-18更新日: 2025-01-18

C#のDataGridViewでErrorProviderを使用するには、まずErrorProviderコンポーネントをフォームに追加します。

次に、DataGridViewのCellValidatingイベントを利用して、セルの値を検証します。

検証が失敗した場合、ErrorProviderのSetErrorメソッドを使用してエラーメッセージを表示します。

例えば、特定のセルが空であってはならない場合、CellValidatingイベント内でそのセルの値をチェックし、空であればErrorProviderを使ってエラーメッセージを設定します。

これにより、ユーザーに入力エラーを視覚的に知らせることができます。

目次から探す

DataGridViewでErrorProviderを使用する手順
応用例
まとめ

DataGridViewでErrorProviderを使用する手順

セルの検証ロジックの実装

DataGridViewのセルに入力されたデータを検証するためには、セルの検証ロジックを実装する必要があります。

以下のサンプルコードでは、特定の条件に基づいてセルの値を検証し、エラーがあればErrorProviderを使用してエラーメッセージを表示します。

partial class MyForm : Form
{
    private ErrorProvider errorProvider;
    public MyForm()
    {
        InitializeComponent();
        errorProvider = new ErrorProvider();
        dataGridView1.CellValidating += DataGridView1_CellValidating;
    }
    private void DataGridView1_CellValidating(object sender, DataGridViewCellValidatingEventArgs e)
    {
        // セルのインデックスが特定の列の場合
        if (e.ColumnIndex == 1) // 例: 1列目を検証
        {
            // 入力値が空でないかを検証
            if (string.IsNullOrWhiteSpace(e.FormattedValue.ToString()))
            {
                errorProvider.SetError(dataGridView1[e.ColumnIndex, e.RowIndex], "このセルは必須です。");
                e.Cancel = true; // 入力をキャンセル
            }
            else
            {
                errorProvider.SetError(dataGridView1[e.ColumnIndex, e.RowIndex], string.Empty);
            }
        }
    }
}

このコードでは、DataGridViewの特定の列に対してセルの検証を行っています。

セルが空である場合、ErrorProviderを使用してエラーメッセージを表示し、入力をキャンセルします。

ErrorProviderのSetErrorメソッドの使用

ErrorProviderのSetErrorメソッドを使用することで、特定のコントロールにエラーメッセージを設定できます。

以下のサンプルコードでは、SetErrorメソッドの使い方を示します。

private void DataGridView1_CellValidating(object sender, DataGridViewCellValidatingEventArgs e)
{
    if (e.ColumnIndex == 1) // 例: 1列目を検証
    {
        if (string.IsNullOrWhiteSpace(e.FormattedValue.ToString()))
        {
            errorProvider.SetError(dataGridView1[e.ColumnIndex, e.RowIndex], "このセルは必須です。");
            e.Cancel = true; // 入力をキャンセル
        }
        else
        {
            errorProvider.SetError(dataGridView1[e.ColumnIndex, e.RowIndex], string.Empty);
        }
    }
}

このコードでは、セルが空である場合にエラーメッセージを設定し、そうでない場合はエラーメッセージをクリアしています。

エラーメッセージの表示とクリア

エラーメッセージは、ユーザーが入力した内容に基づいて表示されます。

エラーが解消された場合は、エラーメッセージをクリアする必要があります。

以下のサンプルコードでは、エラーメッセージの表示とクリアの処理を示します。

private void DataGridView1_CellValidating(object sender, DataGridViewCellValidatingEventArgs e)
{
    if (e.ColumnIndex == 1) // 例: 1列目を検証
    {
        if (string.IsNullOrWhiteSpace(e.FormattedValue.ToString()))
        {
            errorProvider.SetError(dataGridView1[e.ColumnIndex, e.RowIndex], "このセルは必須です。");
            e.Cancel = true; // 入力をキャンセル
        }
        else
        {
            errorProvider.SetError(dataGridView1[e.ColumnIndex, e.RowIndex], string.Empty);
        }
    }
}

このコードでは、セルの値が有効な場合にエラーメッセージをクリアしています。

これにより、ユーザーはエラーが解消されたことを視覚的に確認できます。

応用例

複数列の同時検証

複数の列を同時に検証する場合、各列に対して異なる検証ロジックを適用することができます。

以下のサンプルコードでは、2つの列を検証し、どちらかの列が空であればエラーメッセージを表示します。

private void DataGridView1_CellValidating(object sender, DataGridViewCellValidatingEventArgs e)
{
    if (e.ColumnIndex == 1 || e.ColumnIndex == 2) // 例: 1列目と2列目を検証
    {
        if (string.IsNullOrWhiteSpace(e.FormattedValue.ToString()))
        {
            errorProvider.SetError(dataGridView1[e.ColumnIndex, e.RowIndex], "このセルは必須です。");
            e.Cancel = true; // 入力をキャンセル
        }
        else
        {
            errorProvider.SetError(dataGridView1[e.ColumnIndex, e.RowIndex], string.Empty);
        }
    }
}

このコードでは、1列目または2列目が空である場合にエラーメッセージを表示し、入力をキャンセルします。

カスタムエラーメッセージの設定

エラーメッセージはデフォルトのものを使用するだけでなく、カスタムメッセージを設定することも可能です。

以下のサンプルコードでは、特定の条件に基づいてカスタムエラーメッセージを表示します。

private void DataGridView1_CellValidating(object sender, DataGridViewCellValidatingEventArgs e)
{
    if (e.ColumnIndex == 1) // 例: 1列目を検証
    {
        if (string.IsNullOrWhiteSpace(e.FormattedValue.ToString()))
        {
            errorProvider.SetError(dataGridView1[e.ColumnIndex, e.RowIndex], "必ず値を入力してください。");
            e.Cancel = true; // 入力をキャンセル
        }
        else if (e.FormattedValue.ToString().Length < 3)
        {
            errorProvider.SetError(dataGridView1[e.ColumnIndex, e.RowIndex], "3文字以上で入力してください。");
            e.Cancel = true; // 入力をキャンセル
        }
        else
        {
            errorProvider.SetError(dataGridView1[e.ColumnIndex, e.RowIndex], string.Empty);
        }
    }
}

このコードでは、入力が空である場合や3文字未満の場合に、それぞれ異なるカスタムエラーメッセージを表示します。

入力制限とErrorProviderの組み合わせ

入力制限を設けることで、ユーザーが特定の形式のデータを入力するように促すことができます。

以下のサンプルコードでは、数値のみを許可し、数値以外が入力された場合にエラーメッセージを表示します。

private void DataGridView1_CellValidating(object sender, DataGridViewCellValidatingEventArgs e)
{
    if (e.ColumnIndex == 1) // 例: 1列目を検証
    {
        if (!int.TryParse(e.FormattedValue.ToString(), out _))
        {
            errorProvider.SetError(dataGridView1[e.ColumnIndex, e.RowIndex], "数値を入力してください。");
            e.Cancel = true; // 入力をキャンセル
        }
        else
        {
            errorProvider.SetError(dataGridView1[e.ColumnIndex, e.RowIndex], string.Empty);
        }
    }
}