TextBox.MaxLength Proprietà

Definizione

Ottiene o imposta il numero massimo di caratteri che possono essere immessi manualmente nella casella di testo.

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

Valore della proprietà

Int32

Il numero massimo di caratteri che possono essere immessi manualmente nella casella di testo. Il valore predefinito è 0, che non imposta alcun limite.

Attributi

Esempio

Nell'esempio seguente viene illustrato come creare un TextBox oggetto con un MaxLength valore di 500 caratteri.

<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

Commenti

È possibile usare questa proprietà per limitare la lunghezza del testo immesso nel controllo per i valori, ad esempio codici postali e numeri di telefono. È anche possibile usare questa proprietà per limitare la lunghezza del testo immessa quando i dati devono essere archiviati in un database in modo che il testo immesso nel controllo non superi la lunghezza massima del campo corrispondente nel database.

Questa proprietà non influisce sui caratteri aggiunti a livello di codice.

Quando questa proprietà è impostata su 0, la lunghezza massima del testo che può essere immessa nel controllo è limitata solo dalla memoria disponibile.

Informazioni proprietà di dipendenza

Campo Identificatore MaxLengthProperty
Proprietà dei metadati impostate su true Nessuno

Si applica a

Vedi anche