Freigeben über

TextBoxBase.MaxLength-Eigenschaft

  • Artikel

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Overridable Property MaxLength As Integer
'Usage
Dim instance As TextBoxBase
Dim value As Integer

value = instance.MaxLength

instance.MaxLength = value

[LocalizableAttribute(true)] 
public virtual int MaxLength { get; set; }

[LocalizableAttribute(true)] 
public:
virtual property int MaxLength {
    int get ();
    void set (int value);
}

/** @property */
public int get_MaxLength ()

/** @property */
public void set_MaxLength (int value)

public function get MaxLength () : int

public function set MaxLength (value : int)

Eigenschaftenwert

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

Ausnahmen

Ausnahmetyp Bedingung

ArgumentOutOfRangeException

Der zugewiesene Eigenschaftenwert ist kleiner als 0.

Hinweise

Sie können mit dieser Eigenschaft die Länge des in das Steuerelement eingegebenen Texts für Werte wie Postleitzahlen und Telefonnummern oder für Daten, die in eine Datenbank eingegeben werden sollen, einschränken. Sie können den in das Steuerelement eingegebenen Text auf die maximale Länge des entsprechenden Felds in der Datenbank beschränken.

Hinweis

Sie können den Wert der Text-Eigenschaft im Code auf einen Wert festlegen, der größer als der durch die MaxLength-Eigenschaft angegebene Wert ist. Diese Eigenschaft wirkt sich nur auf Text aus, der zur Laufzeit in das Steuerelement eingegeben wird.

Hinweis zu Windows NT 4.0, Windows 2000, Windows 2000 Professional, Windows 2000 Server, Windows 2000 Advanced Server, Windows XP Home Edition, Windows XP Professional x64 Edition, Windows Server 2003: Wenn für einzeilige Textfeld-Steuerelemente die MaxLength-Eigenschaft auf 0 (null) festgelegt wird, beträgt die maximale Anzahl der Zeichen, die eingegeben werden können, 2147483646 bzw. die Anzahl, die durch den verfügbaren Speicher bestimmt wird, sofern diese geringer ist. Für mehrzeilige Textfeld-Steuerelemente beträgt die maximale Anzahl der Zeichen, die eingegeben werden können, 4294967295 bzw. die Anzahl, die durch den verfügbaren Speicher vorgegeben wird, wenn diese geringer ist.

Hinweis zu Windows Millennium Edition: Wenn für einzeilige Textfeld-Steuerelemente die MaxLength-Eigenschaft auf 0 (null) festgelegt wird, beträgt die maximale Anzahl der Zeichen, die eingegeben werden können, 32.766 bzw. die Anzahl, die durch den verfügbaren Speicher bestimmt wird, sofern diese geringer ist. Für mehrzeilige Textfeld-Steuerelemente beträgt die maximale Anzahl der Zeichen, die eingegeben werden können, 65.535 bzw. die Anzahl, die durch den verfügbaren Speicher vorgegeben wird, wenn diese geringer ist.

Beispiel

Im folgenden Codebeispiel wird mithilfe der abgeleiteten Klasse TextBox ein Textfeld erstellt, mit dem ein Kennwort akzeptiert werden soll. In diesem Beispiel werden mit der CharacterCasing-Eigenschaft alle Zeichen in Großbuchstaben umgewandelt, und mit der MaxLength-Eigenschaft wird die Kennwortlänge auf acht Zeichen beschränkt. In diesem Beispiel wird des Weiteren die TextAlign-Eigenschaft verwendet, um das Kennwort im TextBox-Steuerelement zu zentrieren.

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

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:
   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.set_MaxLength(8);
    // Assign the asterisk to be the password character.
    textBox1.set_PasswordChar('*');
    // Change all text entered to be uppercase.
    textBox1.set_CharacterCasing(CharacterCasing.Upper);
    // Align the text in the center of the TextBox control.
    textBox1.set_TextAlign(HorizontalAlignment.Center);
} //CreateMyPasswordTextBox

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

TextBoxBase-Klasse
TextBoxBase-Member
System.Windows.Forms-Namespace