C# TextBoxに半角英数字と半角カナ文字のみ入力

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

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

案件獲得サイト

エンジニアスタイルとは

アビリティクラウドとは

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

ユニゾンキャリア

テックハブニュービー

C#でWindowsフォームアプリケーションを開発する際、特定の文字種のみをTextBoxに入力させたいケースがよくあります。特に、半角英数字と半角カナ文字のみを許可する要件は、データ入力フォームやユーザー情報登録画面などでよく見られます。この記事では、C#を使用してTextBoxに半角英数字と半角カナ文字のみを入力可能にする方法を、初心者にも分かりやすく解説します。

TextBoxの入力制限の実装方法

TextBoxの入力を制限するには、主にKeyPressイベントを使用します。このイベントは、ユーザーがキーを押すたびに発生し、入力される文字を制御することができます。以下に、半角英数字と半角カナ文字のみを許可する実装方法を示します。

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 (char.IsControl(e.KeyChar))
        {
            return;
        }

        // 半角英数字、半角カナ、スペースのみ許可
        if (!Regex.IsMatch(e.KeyChar.ToString(), @"^[a-zA-Z0-9ｦ-ﾟ\s]$"))
        {
            e.Handled = true; // 入力をキャンセル
        }
    }
}

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

TextBox（textBox1）のKeyPressイベントに、TextBox1_KeyPressメソッドを登録します。
制御文字（バックスペースなど）は常に入力を許可します。これにより、ユーザーが入力を訂正できるようになります。
正規表現を使用して、入力された文字が半角英数字、半角カナ、またはスペースであるかをチェックします。
- [a-zA-Z0-9]: 半角英数字
- ｦ-ﾟ: 半角カナ文字の範囲
- \s: スペース
条件に合わない文字が入力された場合、e.Handled = true;を設定して入力をキャンセルします。

入力された文字列の検証

KeyPressイベントでの制御に加えて、TextBoxの内容全体を検証することも重要です。以下のメソッドを使用して、文字列全体が半角英数字と半角カナ文字のみで構成されているかを確認できます。

private bool IsValidInput(string input)
{
    return Regex.IsMatch(input, @"^[a-zA-Z0-9ｦ-ﾟ\s]*$");
}

このメソッドは、例えばTextBoxのTextChangedイベントや、フォームの送信時に使用できます。

private void textBox1_TextChanged(object sender, EventArgs e)
{
    if (!IsValidInput(textBox1.Text))
    {
        // 無効な入力の場合の処理
        // 例: エラーメッセージの表示やテキストの色を変更など
        textBox1.ForeColor = Color.Red;
    }
    else
    {
        textBox1.ForeColor = Color.Black;
    }
}