TextBox.MaxLength Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví maximální počet znaků, které lze do textového pole zadat ručně.
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
Hodnota vlastnosti
Maximální počet znaků, které lze do textového pole zadat ručně. Výchozí hodnota je 0, což označuje žádný limit.
- Atributy
Příklady
Následující příklad ukazuje, jak vytvořit TextBox s MaxLength 500 znaky.
<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
Poznámky
Tuto vlastnost můžete použít k omezení délky textu zadaného v ovládacím prvku pro hodnoty, jako jsou PSČ a telefonní čísla. Tuto vlastnost můžete použít také k omezení délky textu zadaného při uložení dat do databáze tak, aby text zadaný do ovládacího prvku nepřekročil maximální délku odpovídajícího pole v databázi.
Tato vlastnost nemá vliv na znaky přidané programově.
Pokud je tato vlastnost nastavena na hodnotu 0, maximální délka textu, který lze zadat do ovládacího prvku, je omezen pouze dostupnou pamětí.
Informace o vlastnosti závislosti
Pole identifikátoru | MaxLengthProperty |
Vlastnosti metadat nastavené na true |
Žádné |