TextBoxBase.MaxLength Proprietà

Definizione

Ottiene o imposta il numero massimo di caratteri che l’utente può digitare nel controllo casella di testo.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

Valore della proprietà

Int32

Numero di caratteri che può essere immesso nel controllo.The number of characters that can be entered into the control. Il valore predefinito è 32767.The default is 32767.

Eccezioni

Il valore assegnato alla proprietà è minore di zero.The value assigned to the property is less than 0.

Esempio

Nell'esempio di codice seguente viene utilizzata la classe derivata, TextBox , per creare una casella di testo utilizzata per accettare una password.The following code example uses the derived class, TextBox, to create a text box that is used to accept a password. In questo esempio viene utilizzata la CharacterCasing proprietà per modificare tutti i caratteri digitati in lettere maiuscole e la MaxLength proprietà per limitare la lunghezza della password a otto caratteri.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. In questo esempio viene inoltre utilizzata la TextAlign proprietà per centrare la password nel TextBox controllo.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

Commenti

È possibile utilizzare questa proprietà per limitare la lunghezza del testo immesso nel controllo per valori quali codici postali e numeri di telefono oppure per limitare la lunghezza del testo immesso quando i dati devono essere immessi in un database.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. È possibile limitare il testo immesso nel controllo alla lunghezza massima del campo corrispondente nel database.You can limit the text entered into the control to the maximum length of the corresponding field in the database.

Nota

Nel codice è possibile impostare il valore della Text proprietà su un valore con una lunghezza maggiore del valore specificato dalla MaxLength Proprietà.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. Questa proprietà influiscono solo sul testo immesso nel controllo in fase di esecuzione.This property only affects text entered into the control at run time.

Si applica a