TextBox.MaxLength Properti

Definisi

Ruang nama:

System.Windows.Controls

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur jumlah maksimum karakter yang dapat dimasukkan secara manual ke dalam kotak teks.

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

Nilai Properti

Int32

Jumlah maksimum karakter yang dapat dimasukkan secara manual ke dalam kotak teks. Defaultnya adalah 0, yang menunjukkan tidak ada batasan.

Atribut

LocalizabilityAttribute

Contoh

Contoh berikut menunjukkan cara membuat TextBox dengan MaxLength 500 karakter.

<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

Keterangan

Anda dapat menggunakan properti ini untuk membatasi panjang teks yang dimasukkan dalam kontrol untuk nilai seperti kode pos dan nomor telepon. Anda juga bisa menggunakan properti ini untuk membatasi panjang teks yang dimasukkan saat data akan disimpan dalam database sehingga teks yang dimasukkan ke dalam kontrol tidak melebihi panjang maksimum bidang terkait dalam database.

Properti ini tidak memengaruhi karakter yang ditambahkan secara terprogram.

Ketika properti ini diatur ke 0, panjang maksimum teks yang dapat dimasukkan dalam kontrol hanya dibatasi oleh memori yang tersedia.

Informasi Properti Dependensi

Bidang pengidentifikasi	MaxLengthProperty
Properti metadata diatur ke true	Tidak ada

Lihat juga

• MaxLines