[C#][Windows Formsアプリ][TextBox] MaxLengthプロパティで文字数の上限を設定しよう

スポンサーリンク

はじめに

ユーザーに自由に入力させると、時には長すぎる文字列が入ってしまうことがあります。
そこで便利なのが MaxLengthプロパティ です。
これを使えば、TextBoxに入力できる文字数の上限を制御できます。

1. MaxLengthプロパティとは?

MaxLength プロパティは、ユーザーが入力できる文字数の上限を指定します。
既定値は 32767 ですが、必要に応じてもっと小さい値を設定できます。

例:MaxLength = 10 と設定すると、ユーザーは最大10文字までしか入力できません。

2. 基本の使い方

デザイナーで設定する方法

  1. フォーム上のTextBoxを選択する
  2. プロパティウィンドウの MaxLength に制限したい文字数を入力する

コードで設定する方法

textBox1.MaxLength = 20; // 最大20文字まで

3. 実用例:ユーザーID入力欄

using System;
using System.Windows.Forms;

namespace MaxLengthSample
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();

            // ユーザーIDは最大12文字まで
            textBoxUserId.MaxLength = 12;
        }

        private void button1_Click(object sender, EventArgs e)
        {
            string userId = textBoxUserId.Text;
            MessageBox.Show("入力されたID: " + userId);
        }
    }
}

このように MaxLength を設定するだけで、
入力文字数を簡単に制御できます。

4. 注意点

  • コピー&ペースト時も制御される
    → 上限を超える文字列を貼り付けても、自動的に切り捨てられます。
  • 複数行TextBoxでも有効
    Multiline = true の場合でも、全体の文字数制限として機能します。
  • ゼロや負数は指定不可
    → 有効な範囲は1~32767です。

まとめ

  • MaxLength は入力可能な文字数を制限できる便利なプロパティ
  • フォーム入力の品質を保つのに必須
  • コピー&ペースト時も自動で制御される点に注意

入力フォームを設計するときは、
必ず「どの項目にどれくらいの文字数が必要か」を考えて
MaxLength を設定すると良いでしょう。

 

Please follow and like us:

コメント

タイトルとURLをコピーしました