TextBoxBase.MaxLength プロパティ

定義

ユーザーがテキスト ボックス コントロールに入力または貼り付けできる最大文字数を取得または設定します。Gets or sets the maximum number of characters the user can type or paste into the text box control.

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

プロパティ値

コントロールに入力できる文字数。The number of characters that can be entered into the control. 既定値は32767です。The default is 32767.

例外

プロパティに代入された値が 0 未満です。The value assigned to the property is less than 0.

次のコード例では、派生クラスTextBoxを使用して、パスワードの受け入れに使用するテキストボックスを作成します。The following code example uses the derived class, TextBox, to create a text box that is used to accept a password. この例ではCharacterCasing 、プロパティを使用して、大文字MaxLengthに変換されたすべての文字を変更し、プロパティを使用してパスワードの長さを8文字に制限しています。This example uses the CharacterCasing property to change all characters typed to uppercase and the MaxLength property to restrict the password length to eight characters. また、この例でTextAlignは、プロパティを使用してTextBox 、コントロール内のパスワードを中央に配置します。This example also uses the TextAlign property to center the password in the TextBox control.

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

注釈

このプロパティを使用すると、郵便番号や電話番号などの値に対してコントロールに入力されるテキストの長さを制限したり、データベースにデータを入力するときに入力するテキストの長さを制限したりすることができます。You can use this property to restrict the length of text entered in the control for values such as postal codes and telephone numbers, or to restrict the length of text entered when the data is to be entered in a database. コントロールに入力されたテキストを、データベース内の対応するフィールドの最大長に制限できます。You can limit the text entered into the control to the maximum length of the corresponding field in the database.

注意

コードでは、プロパティのText値を、 MaxLengthプロパティで指定された値よりも長い長さの値に設定できます。In code, you can set the value of the Text property to a value that has a length greater than the value specified by the MaxLength property. このプロパティは、実行時にコントロールに入力されたテキストにのみ影響します。This property only affects text entered into the control at run time.

適用対象