TextBoxBase.MaxLength Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft die maximale Anzahl an Zeichen ab, die Benutzer in das Textfeld-Steuerelement eingeben oder einfügen können, oder legt diese fest.

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

Eigenschaftswert

Int32

Die Anzahl der Zeichen, die in das Steuerelement eingegeben werden können. Der Standardwert ist 32767.

Ausnahmen

ArgumentOutOfRangeException

Der zugewiesene Eigenschaftswert ist kleiner als 0 (null).

Beispiele

Im folgenden Codebeispiel wird die abgeleitete Klasse verwendet, um ein Textfeld zu erstellen, TextBoxdas verwendet wird, um ein Kennwort zu akzeptieren. In diesem Beispiel wird die Eigenschaft verwendet, um alle Zeichen zu ändern, die CharacterCasing in Großbuchstaben eingegeben werden, und die MaxLength Eigenschaft, um die Kennwortlänge auf acht Zeichen einzuschränken. In diesem Beispiel wird auch die Eigenschaft verwendet, um das TextAlign Kennwort im TextBox Steuerelement zu zentrieren.

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

Hinweise

Sie können diese Eigenschaft verwenden, um die in das Steuerelement eingegebene Textlänge für Werte wie Postleitzahlen und Telefonnummern einzuschränken oder die Textlänge einzuschränken, die eingegeben werden soll, wenn die Daten in eine Datenbank eingegeben werden sollen. Sie können den in das Steuerelement eingegebenen Text auf die maximale Länge des entsprechenden Felds in der Datenbank beschränken.

Hinweis

Im Code können Sie den Wert der Text Eigenschaft auf einen Wert festlegen, der eine Länge größer als der durch die MaxLength Eigenschaft angegebene Wert aufweist. Diese Eigenschaft wirkt sich nur auf Text aus, der zur Laufzeit in das Steuerelement eingegeben wird.