次の方法で共有

TextBoxBase.MaxLength プロパティ

  • [アーティクル]

ユーザーがテキスト ボックス コントロールに入力または貼り付けできる最大文字数を取得または設定します。

Public Overridable Property MaxLength As Integer
[C#]
public virtual int MaxLength {get; set;}
[C++]
public: __property virtual int get_MaxLength();public: __property virtual void set_MaxLength(int);
[JScript]
public function get MaxLength() : int;public function set MaxLength(int);

プロパティ値

コントロールに入力できる文字数。既定値は 32767 です。

例外

例外の種類 条件
ArgumentException プロパティに代入された値が 0 未満です。

解説

このプロパティを使用すると、郵便番号や電話番号などの値を入力するコントロールのテキストの長さや、データベースにデータを入力するときのテキストの長さを制限できます。コントロールに入力するテキストの長さを、データベースの該当フィールドの最大の長さ以下に制限できます。

メモ   コードでは、 Text プロパティの値を MaxLength プロパティで指定した値よりも長い値に設定できます。このプロパティは、実行時にコントロールに入力されるテキストにだけ影響します。

Windows NT 4.0, Windows 2000, Windows Server 2003 ファミリ プラットフォームに関する注意点: 単一行テキスト ボックス コントロールで MaxLength プロパティを 0 に設定した場合、ユーザーが入力できる最大文字数は、2147483646 または使用可能なメモリに応じたサイズのうち、いずれか小さい数となります。複数行テキスト ボックス コントロールの場合、ユーザーが入力できる最大文字数は、4294967295 または使用可能なメモリに応じたサイズのうち、いずれか小さい数となります。

Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition プラットフォームに関する注意点: 単一行テキスト ボックス コントロールで MaxLength プロパティを 0 に設定した場合、ユーザーが入力できる最大文字数は、32,766 または使用可能なメモリに応じたサイズのうち、いずれか小さい数となります。複数行テキスト ボックス コントロールの場合、ユーザーが入力できる最大文字数は、65,535 または使用可能なメモリに応じたサイズのうち、いずれか小さい数となります。

使用例

[Visual Basic, C#, C++] 派生クラス TextBox を使用して、パスワードを受け入れるために使用されるテキスト ボックスを作成する例を次に示します。この例では、 CharacterCasing プロパティを使用して、入力されたすべての文字を大文字に変更します。また、 MaxLength プロパティを使用して、パスワード長を 8 文字に制限します。この例では、 TextAlign プロパティも使用して、 TextBox コントロールの中央にパスワードを配置します。

 
Public Sub CreateMyPasswordTextBox()
    ' Create an instance of the TextBox control.
    Dim textBox1 As New TextBox()
    ' Set the maximum length of text in the control to eight.
    textBox1.MaxLength = 8
    ' Assign the asterisk to be the password character.
    textBox1.PasswordChar = "*"c
    ' Change all text entered to be lowercase.
    textBox1.CharacterCasing = CharacterCasing.Upper
    ' Align the text in the center of the TextBox control.
    textBox1.TextAlign = HorizontalAlignment.Center
End Sub

[C#] 
public void CreateMyPasswordTextBox()
 {
    // Create an instance of the TextBox control.
    TextBox textBox1 = new TextBox();
    // Set the maximum length of text in the control to eight.
    textBox1.MaxLength = 8;
    // Assign the asterisk to be the password character.
    textBox1.PasswordChar = '*';
    // Change all text entered to be lowercase.
    textBox1.CharacterCasing = CharacterCasing.Upper;
    // Align the text in the center of the TextBox control.
    textBox1.TextAlign = HorizontalAlignment.Center;
 }

[C++] 
public:
void CreateMyPasswordTextBox()
 {
    // Create an instance of the TextBox control.
    TextBox* textBox1 = new TextBox();
    // Set the maximum length of text in the control to eight.
    textBox1->MaxLength = 8;
    // Assign the asterisk to be the password character.
    textBox1->PasswordChar = '*';
    // Change all text entered to be lowercase.
    textBox1->CharacterCasing = CharacterCasing::Upper;
    // Align the text in the center of the TextBox control.
    textBox1->TextAlign = HorizontalAlignment::Center;
 }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

TextBoxBase クラス | TextBoxBase メンバ | System.Windows.Forms 名前空間