TextBox.MaxLength Özellik

Tanım

Ad Alanı:

System.Windows.Controls

Bütünleştirilmiş Kod:

PresentationFramework.dll

Metin kutusuna el ile girilebilen en fazla karakter sayısını alır veya ayarlar.

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

Özellik Değeri

Int32

Metin kutusuna el ile girilebilen en fazla karakter sayısı. Varsayılan değer 0'dır ve sınır yoktur.

Öznitelikler

LocalizabilityAttribute

Örnekler

Aşağıdaki örnekte 500 karakterden oluşan bir TextBox MaxLength öğesinin nasıl oluşturulacağı gösterilmektedir.

<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

Açıklamalar

Posta kodları ve telefon numaraları gibi değerler için denetime girilen metnin uzunluğunu kısıtlamak için bu özelliği kullanabilirsiniz. Denetime girilen metnin veritabanındaki ilgili alanın uzunluk üst sınırını aşmaması için, veriler bir veritabanında depolanacakken girilen metnin uzunluğunu kısıtlamak için de bu özelliği kullanabilirsiniz.

Bu özellik, program aracılığıyla eklenen karakterleri etkilemez.

Bu özellik 0 olarak ayarlandığında, denetime girilebilecek metnin uzunluk üst sınırı yalnızca kullanılabilir bellekle sınırlıdır.

Bağımlılık Özelliği Bilgileri

Tanımlayıcı alanı	MaxLengthProperty
Meta veri özellikleri olarak ayarlandı true	Hiçbiri

Ayrıca bkz.

• MaxLines