C# テキストボックスで特定の文字だけを許可する

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

2024年9月12日2024年11月29日

案件獲得サイト

エンジニアスタイルとは

アビリティクラウドとは

未経験歓迎転職（手取り20万以下の人は絶対転職して！！）

ユニゾンキャリア

テックハブニュービー

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)
    {
        // 数字とバックスペース以外の文字は無効化
        if (!char.IsDigit(e.KeyChar) && e.KeyChar != (char)Keys.Back)
        {
            e.Handled = true;
        }
    }
}

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

textBox1.KeyPress += TextBox1_KeyPress; で、テキストボックスのKeyPressイベントにイベントハンドラを追加します。
char.IsDigit(e.KeyChar) で、入力された文字が数字かどうかをチェックします。
e.KeyChar != (char)Keys.Back で、バックスペースキーを許可します。
条件に合わない場合、e.Handled = true; で入力をキャンセルします。

正規表現を使用する方法

より複雑な入力制限が必要な場合は、正規表現を使用する方法も効果的です。以下は、英字と数字のみを許可する例です：

using System;
using System.Windows.Forms;
using System.Text.RegularExpressions;

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

    private void TextBox1_KeyPress(object sender, KeyPressEventArgs e)
    {
        if (e.KeyChar == (char)Keys.Back) return; // バックスペースは常に許可

        string pattern = @"^[a-zA-Z0-9]$";
        if (!Regex.IsMatch(e.KeyChar.ToString(), pattern))
        {
            e.Handled = true;
        }
    }
}

このコードでは：

^[a-zA-Z0-9]$ というパターンで、英字と数字のみにマッチする正規表現を定義しています。
Regex.IsMatch() メソッドで、入力文字が正規表現パターンに一致するかをチェックします。

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

入力後にテキストを検証したい場合は、TextChangedイベントを使用します。これは、テキストボックスの内容が変更されるたびに発生するイベントです。

using System;
using System.Windows.Forms;
using System.Text.RegularExpressions;

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

    private void TextBox1_TextChanged(object sender, EventArgs e)
    {
        string pattern = @"^[a-zA-Z0-9]*$";
        if (!Regex.IsMatch(textBox1.Text, pattern))
        {
            int selectionStart = textBox1.SelectionStart;
            textBox1.Text = Regex.Replace(textBox1.Text, @"[^a-zA-Z0-9]", "");
            textBox1.SelectionStart = selectionStart - 1;
        }
    }
}

このアプローチでは：