RichTextBox.MaxLength Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

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

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

public override int MaxLength { get; set; }

member this.MaxLength : int with get, set

Public Overrides Property MaxLength As Integer

Nilai Properti

Int32

Jumlah karakter yang dapat dimasukkan ke dalam kontrol. Defaultnya adalah Int32.MaxValue.

Pengecualian

ArgumentException

Nilai yang ditetapkan ke properti kurang dari 0.

Contoh

Contoh kode berikut menunjukkan cara menggunakan MaxLength properti untuk menentukan apakah teks yang RichTextBox ditetapkan ke kontrol lebih besar dari nilai yang ditetapkan ke MaxLength properti . Jika teks tidak lebih besar, contohnya menggunakan SelectedText properti untuk menetapkan teks ke kontrol. Contoh ini mengharuskan RichTextBox kontrol, bernama richTextBox1, telah ditambahkan ke formulir dan bahwa metode dalam contoh dipanggil dengan teks yang disediakan ke parameter yang akan ditempelkan ke dalam kontrol. Contoh ini juga mengharuskan MaxLength properti telah diatur ke nilai untuk membatasi entri teks ke RichTextBoxdalam .

private:
   void AddMyText( String^ textToAdd )
   {
      // Determine if the text to add is larger than the max length property.
      if ( textToAdd->Length > richTextBox1->MaxLength )
         // Alert user text is too large.
         MessageBox::Show( "The text is too large to add to the RichTextBox" ); // Add the text to be added to the control.
      else
         richTextBox1->SelectedText = textToAdd;
   }

private void AddMyText(string textToAdd)
{
    // Determine if the text to add is larger than the max length property.
    if (textToAdd.Length > richTextBox1.MaxLength)
        // Alert user text is too large.
        MessageBox.Show("The text is too large to addo to the RichTextBox");
    else
        // Add the text to be added to the control.
        richTextBox1.SelectedText = textToAdd;
}

Private Sub AddMyText(ByVal textToAdd As String)
    ' Determine if the text to add is larger than the max length property.
    If textToAdd.Length > richTextBox1.MaxLength Then
        ' Alert user text is too large.
        MessageBox.Show("The text is too large to addo to the RichTextBox")
        ' Add the text to be added to the control.
    Else
        richTextBox1.SelectedText = textToAdd
    End If
End Sub

Keterangan

Ketika properti ini diatur ke 0, panjang maksimum teks yang dapat dimasukkan dalam kontrol adalah 64 KB karakter. Properti ini biasanya digunakan saat RichTextBox digunakan untuk menampilkan satu baris teks format teks kaya (RTF). Anda bisa 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 bisa membatasi teks yang dimasukkan ke dalam kontrol ke panjang maksimum bidang terkait dalam database.

Catatan

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 mempengaruhi teks yang dimasukkan ke dalam kontrol pada durasi.

Lihat juga

• MaxLength