C# テキストボックスに禁止文字を設定する

2024年9月14日

C#でWindowsフォームアプリケーションを開発する際、ユーザーの入力を制限したい場面がよくあります。特に、特定の文字の入力を禁止することで、データの整合性を保ったり、セキュリティリスクを軽減したりすることができます。この記事では、C#を使ってテキストボックスに禁止文字を設定する方法を、初心者にも分かりやすく解説します。

KeyPressイベントを使用する方法

テキストボックスに禁止文字を設定する最も一般的な方法は、KeyPressイベントを使用することです。このイベントは、ユーザーがキーを押すたびに発生し、入力される文字を制御することができます。

以下に、特定の文字（この例では「@」と「#」）を禁止する基本的なコード例を示します：

using System;
using System.Windows.Forms;

public partial class Form1 : Form
{
    public Form1()
    {
        InitializeComponent();
        textBox1.KeyPress += TextBox1_KeyPress;
    }

    private void TextBox1_KeyPress(object sender, KeyPressEventArgs e)
    {
        // 禁止文字のリスト
        char[] forbiddenChars = { '@', '#' };

        // 入力された文字が禁止文字リストに含まれている場合、入力をキャンセル
        if (Array.IndexOf(forbiddenChars, e.KeyChar) >= 0)
        {
            e.Handled = true;
            MessageBox.Show("@ と # は使用できません。", "入力エラー", MessageBoxButtons.OK, MessageBoxIcon.Warning);
        }
    }
}

このコードの主なポイントは以下の通りです：

textBox1.KeyPress += TextBox1_KeyPress; で、テキストボックスのKeyPressイベントにイベントハンドラを追加します。
forbiddenChars 配列に禁止したい文字を定義します。
Array.IndexOf メソッドを使用して、入力された文字が禁止文字リストに含まれているかチェックします。
禁止文字が入力された場合、e.Handled = true; で入力をキャンセルし、警告メッセージを表示します。

TextChangedイベントを使用する方法

KeyPressイベントの代わりに、TextChangedイベントを使用することもできます。この方法は、コピー＆ペーストなどの操作にも対応できる利点があります。

using System;
using System.Windows.Forms;
using System.Linq;

public partial class Form1 : Form
{
    private readonly char[] forbiddenChars = { '@', '#' };

    public Form1()
    {
        InitializeComponent();
        textBox1.TextChanged += TextBox1_TextChanged;
    }

    private void TextBox1_TextChanged(object sender, EventArgs e)
    {
        TextBox textBox = (TextBox)sender;
        int cursorPosition = textBox.SelectionStart;

        // 禁止文字を削除
        string cleanedText = new string(textBox.Text.Where(c => !forbiddenChars.Contains(c)).ToArray());

        if (textBox.Text != cleanedText)
        {
            textBox.Text = cleanedText;
            textBox.SelectionStart = cursorPosition - 1;
            MessageBox.Show("@ と # は使用できません。", "入力エラー", MessageBoxButtons.OK, MessageBoxIcon.Warning);
        }
    }
}

この方法では、テキストが変更されるたびに禁止文字をチェックし、削除します。