C# TextBoxに数字しか入力できないようにする

2024年9月12日

Windowsフォームアプリケーションやデスクトップアプリの開発において、ユーザーからの入力を制御することは非常に重要です。特に、数値のみを入力させたい場合、TextBoxに数字以外の文字が入力されないようにする必要があります。この記事では、C#を使用してTextBoxに数字のみを入力可能にする方法を、初心者にも分かりやすく解説します。

TextBoxに数字のみを入力可能にする基本的な方法

TextBoxに数字のみを入力可能にするには、主に以下の2つのアプローチがあります：

KeyPressイベントを使用する方法
正規表現を使用する方法

ここでは、より直感的で理解しやすいKeyPressイベントを使用する方法を紹介します。

using System;
using System.Windows.Forms;

public partial class Form1 : Form
{
    public Form1()
    {
        InitializeComponent();
        
        // TextBoxのKeyPressイベントにイベントハンドラを追加
        textBox1.KeyPress += TextBox1_KeyPress;
    }

    private void TextBox1_KeyPress(object sender, KeyPressEventArgs e)
    {
        // 入力された文字が数字でない場合は、イベントをキャンセルする
        if (!char.IsDigit(e.KeyChar) && e.KeyChar != '\b')
        {
            e.Handled = true;
        }
    }
}

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

TextBoxのKeyPressイベントにイベントハンドラ（TextBox1_KeyPress）を追加します。
イベントハンドラ内で、入力された文字（e.KeyChar）が数字かどうかをチェックします。
char.IsDigit()メソッドを使用して、文字が数字かどうかを判定します。
バックスペースキー（’\b’）も許可します。これにより、ユーザーが入力を訂正できるようになります。
入力された文字が数字でもバックスペースでもない場合、e.Handled = true; を設定してイベントをキャンセルし、文字の入力を防ぎます。

より高度な制御：小数点の入力を許可する

場合によっては、整数だけでなく小数点を含む数値の入力も許可したい場合があります。以下のコードは、小数点の入力も許可する例です。

private void TextBox1_KeyPress(object sender, KeyPressEventArgs e)
{
    // 数字、バックスペース、小数点を許可
    if (!char.IsDigit(e.KeyChar) && e.KeyChar != '\b' && e.KeyChar != '.')
    {
        e.Handled = true;
        return;
    }

    // 小数点が既に存在する場合は、2つ目の小数点を許可しない
    if (e.KeyChar == '.' && ((TextBox)sender).Text.IndexOf('.') > -1)
    {
        e.Handled = true;
    }
}

このコードでは、以下の点に注意してください：