TextBoxBase.MaxLength プロパティ

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

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

public:
 virtual property int MaxLength { int get(); void set(int value); };

public virtual int MaxLength { get; set; }

member this.MaxLength : int with get, set

Public Overridable Property MaxLength As Integer

プロパティ値

Int32

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

例外

ArgumentOutOfRangeException

プロパティに代入された値が 0 未満です。

例

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

public:
   void CreateMyPasswordTextBox()
   {
      // Create an instance of the TextBox control.
      TextBox^ textBox1 = gcnew 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 uppercase.
      textBox1->CharacterCasing = CharacterCasing::Upper;
      // Align the text in the center of the TextBox control.
      textBox1->TextAlign = HorizontalAlignment::Center;
   }

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 uppercase.
    textBox1.CharacterCasing = CharacterCasing.Upper;
    // Align the text in the center of the TextBox control.
    textBox1.TextAlign = HorizontalAlignment.Center;
 }

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 uppercase.
    textBox1.CharacterCasing = CharacterCasing.Upper
    ' Align the text in the center of the TextBox control.
    textBox1.TextAlign = HorizontalAlignment.Center
End Sub

注釈

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

注意

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