TextBox.MaxLength Eigenschaft

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Ruft die maximale Anzahl der Zeichen ab, die manuell in das Textfeld eingegeben werden können, oder legt diese fest.

public:
 property int MaxLength { int get(); void set(int value); };

[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Modifiability=System.Windows.Modifiability.Unmodifiable)]
public int MaxLength { get; set; }

[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Modifiability=System.Windows.Modifiability.Unmodifiable)>]
member this.MaxLength : int with get, set

Public Property MaxLength As Integer

Eigenschaftswert

Int32

Die maximale Anzahl der Zeichen, die manuell in das Textfeld eingegeben werden können. Der Standardwert ist 0, d. h. unbegrenzt.

Attribute

LocalizabilityAttribute

Beispiele

Das folgende Beispiel zeigt, wie Sie eine TextBox mit MaxLength 500 Zeichen erstellen.

<Page  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
  <StackPanel>
    <TextBox 
      Text="Initial text in TextBox" 
      Width="200" 
      TextAlignment="Center"
      TextWrapping="Wrap" 
      MaxLength="500"
      MinLines="1" 
      MaxLines="5" />
  </StackPanel>
</Page>

StackPanel myStackPanel = new StackPanel();

//Create TextBox
TextBox myTextBox = new TextBox();
myTextBox.Width = 200;

// Put some initial text in the TextBox.
myTextBox.Text = "Initial text in TextBox";

// Set the maximum characters a user can manually type
// into the TextBox.
myTextBox.MaxLength = 500;
myTextBox.MinLines = 1;

// Set the maximum number of lines the TextBox will expand to 
// accomidate text. Note: This does not constrain the amount of 
// text that can be typed. To do that, use the MaxLength property.
myTextBox.MaxLines = 5;

// The text typed into the box is aligned in the center.
myTextBox.TextAlignment = TextAlignment.Center;

// When the text reaches the edge of the box, go to the next line.
myTextBox.TextWrapping = TextWrapping.Wrap;

myStackPanel.Children.Add(myTextBox);
this.Content = myStackPanel;

Dim myStackPanel As New StackPanel()

'Create TextBox
Dim myTextBox As New TextBox()
myTextBox.Width = 200

' Put some initial text in the TextBox.
myTextBox.Text = "Initial text in TextBox"

' Set the maximum characters a user can manually type
' into the TextBox.
myTextBox.MaxLength = 500
myTextBox.MinLines = 1

' Set the maximum number of lines the TextBox will expand to 
' accomidate text. Note: This does not constrain the amount of 
' text that can be typed. To do that, use the MaxLength property.
myTextBox.MaxLines = 5

' The text typed into the box is aligned in the center.
myTextBox.TextAlignment = TextAlignment.Center

' When the text reaches the edge of the box, go to the next line.
myTextBox.TextWrapping = TextWrapping.Wrap

myStackPanel.Children.Add(myTextBox)
Me.Content = myStackPanel

Hinweise

Mit dieser Eigenschaft können Sie die im Steuerelement eingegebene Textlänge für Werte wie Postleitzahlen und Telefonnummern einschränken. Sie können diese Eigenschaft auch verwenden, um die Länge des eingegebenen Texts einzuschränken, wenn die Daten in einer Datenbank gespeichert werden sollen, damit der in das Steuerelement eingegebene Text die maximale Länge des entsprechenden Felds in der Datenbank nicht überschreitet.

Diese Eigenschaft wirkt sich nicht auf Zeichen aus, die programmgesteuert hinzugefügt werden.

Wenn diese Eigenschaft auf 0 festgelegt ist, ist die maximale Länge des Texts, der in das Steuerelement eingegeben werden kann, nur durch den verfügbaren Arbeitsspeicher begrenzt.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	MaxLengthProperty
Metadateneigenschaften auf true festgelegt	Keine

Siehe auch

• MaxLines