TextBox.MaxLength Propriété

Définition

Espace de noms:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Obtient ou définit le nombre maximal de caractères pouvant être entrés manuellement dans la zone de texte.

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

Valeur de propriété

Int32

Nombre maximal de caractères qui peuvent être entrés manuellement dans la zone de texte. La valeur par défaut est 0, ce qui n'indique aucune limite.

Attributs

LocalizabilityAttribute

Exemples

L’exemple suivant montre comment créer un TextBox avec MaxLength 500 caractères.

<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

Remarques

Vous pouvez utiliser cette propriété pour limiter la longueur du texte entré dans le contrôle pour les valeurs telles que les codes postaux et les numéros de téléphone. Vous pouvez également utiliser cette propriété pour limiter la longueur du texte entré lorsque les données doivent être stockées dans une base de données afin que le texte entré dans le contrôle ne dépasse pas la longueur maximale du champ correspondant dans la base de données.

Cette propriété n’affecte pas les caractères ajoutés par programme.

Lorsque cette propriété est définie sur 0, la longueur maximale du texte pouvant être entré dans le contrôle est limitée uniquement par la mémoire disponible.

Informations sur les propriétés de dépendance

Champ d’identificateur	MaxLengthProperty
Propriétés de métadonnées définies sur true	Aucun

Voir aussi

• MaxLines