TextBoxBase.MaxLength Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

TextBoxBase.cs

Ruft die maximale Anzahl von Zeichen ab, die der Benutzer in das Textfeld-Steuerelement eingeben oder einfügen kann, 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 der Eigenschaft zugewiesene Wert ist kleiner als 0.

Beispiele

Im folgenden Codebeispiel wird die abgeleitete Klasse verwendet, TextBoxum ein Textfeld zu erstellen, das zum Akzeptieren eines Kennworts verwendet wird. In diesem Beispiel wird die CharacterCasing Eigenschaft verwendet, um alle in Großbuchstaben eingegebenen Zeichen und die MaxLength Eigenschaft so zu ändern, dass die Kennwortlänge auf acht Zeichen beschränkt wird. In diesem Beispiel wird auch die TextAlign Eigenschaft verwendet, um das 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 Textlänge einzuschränken, die in das Steuerelement eingegeben wurde, für Werte wie Postleitzahlen und Telefonnummern, oder um 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 größer als der von der MaxLength Eigenschaft angegebene Wert ist. Diese Eigenschaft wirkt sich nur auf Text aus, der zur Laufzeit in das Steuerelement eingegeben wurde.