TextBoxBase.MaxLength Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

TextBoxBase.cs

Mendapatkan atau mengatur jumlah maksimum karakter yang dapat diketik atau ditempelkan pengguna ke kontrol kotak teks.

public:
 virtual property int MaxLength { int get(); void set(int value); };

public virtual int MaxLength { get; set; }

member this.MaxLength : int with get, set

Public Overridable Property MaxLength As Integer

Nilai Properti

Int32

Jumlah karakter yang dapat dimasukkan ke dalam kontrol. Defaultnya adalah 32767.

Pengecualian

ArgumentOutOfRangeException

Nilai yang ditetapkan ke properti kurang dari 0.

Contoh

Contoh kode berikut menggunakan kelas turunan, TextBox, untuk membuat kotak teks yang digunakan untuk menerima kata sandi. Contoh ini menggunakan properti untuk mengubah semua karakter yang CharacterCasing di ketik menjadi huruf besar dan MaxLength properti untuk membatasi panjang kata sandi menjadi delapan karakter. Contoh ini juga menggunakan properti untuk mempusatkan TextAlign kata sandi dalam TextBox kontrol.

public:
   void CreateMyPasswordTextBox()
   {
      // Create an instance of the TextBox control.
      TextBox^ textBox1 = gcnew TextBox;
      // Set the maximum length of text in the control to eight.
      textBox1->MaxLength = 8;
      // Assign the asterisk to be the password character.
      textBox1->PasswordChar = '*';
      // Change all text entered to be uppercase.
      textBox1->CharacterCasing = CharacterCasing::Upper;
      // Align the text in the center of the TextBox control.
      textBox1->TextAlign = HorizontalAlignment::Center;
   }

public void CreateMyPasswordTextBox()
 {
    // Create an instance of the TextBox control.
    TextBox textBox1 = new TextBox();
    // Set the maximum length of text in the control to eight.
    textBox1.MaxLength = 8;
    // Assign the asterisk to be the password character.
    textBox1.PasswordChar = '*';
    // Change all text entered to be uppercase.
    textBox1.CharacterCasing = CharacterCasing.Upper;
    // Align the text in the center of the TextBox control.
    textBox1.TextAlign = HorizontalAlignment.Center;
 }

Public Sub CreateMyPasswordTextBox()
    ' Create an instance of the TextBox control.
    Dim textBox1 As New TextBox()
    ' Set the maximum length of text in the control to eight.
    textBox1.MaxLength = 8
    ' Assign the asterisk to be the password character.
    textBox1.PasswordChar = "*"c
    ' Change all text entered to be uppercase.
    textBox1.CharacterCasing = CharacterCasing.Upper
    ' Align the text in the center of the TextBox control.
    textBox1.TextAlign = HorizontalAlignment.Center
End Sub

Keterangan

Anda dapat menggunakan properti ini untuk membatasi panjang teks yang dimasukkan dalam kontrol untuk nilai seperti kode pos dan nomor telepon, atau untuk membatasi panjang teks yang dimasukkan saat data akan dimasukkan dalam database. Anda dapat membatasi teks yang dimasukkan ke dalam kontrol ke panjang maksimum bidang terkait dalam database.

Nota

Dalam kode, Anda dapat mengatur nilai Text properti ke nilai yang memiliki panjang lebih besar dari nilai yang ditentukan oleh MaxLength properti . Properti ini hanya memengaruhi teks yang dimasukkan ke dalam kontrol pada waktu proses.