RichTextBox.MaxLength Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kullanıcının zengin metin kutusu denetimine yazabileceği veya yapıştırabileceği en fazla karakter sayısını alır veya ayarlar.

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

Özellik Değeri

Int32

Denetime girilebilen karakter sayısı. Varsayılan değer Int32.MaxValue'dur.

Özel durumlar

ArgumentException

özelliğine atanan değer 0'dan küçüktür.

Örnekler

Aşağıdaki kod örneği, bir denetime atanan metnin özelliğe atanan değerden daha büyük olup olmadığını belirlemek için RichTextBoxMaxLength özelliğinin nasıl kullanılacağını MaxLength gösterir. Metin daha büyük değilse, örnek denetimine SelectedText metin atamak için özelliğini kullanır. Bu örnek, adlı richTextBox1bir RichTextBox denetimin forma eklenmesini ve örnekteki yöntemin denetime yapıştırılacak parametreye sağlanan metinle çağrılmayı gerektirir. Örnek ayrıca özelliğinin MaxLength içine metin girişini sınırlamak için bir değere ayarlanmasını RichTextBoxgerektirir.

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

Açıklamalar

Bu özellik 0 olarak ayarlandığında, denetime girilebilen metnin uzunluk üst sınırı 64 KB karakterdir. Bu özellik genellikle RichTextBox zengin metin biçimi (RTF) metninin tek bir satırını görüntülemek için kullanıldığında kullanılır. Bu özelliği, posta kodları ve telefon numaraları gibi değerler için denetime girilen metnin uzunluğunu kısıtlamak veya veriler veritabanına girilecekken girilen metnin uzunluğunu kısıtlamak için kullanabilirsiniz. Denetime girilen metni veritabanındaki ilgili alanın uzunluk üst sınırıyla sınırlayabilirsiniz.

Not

Kodda, özelliğin Text değerini, özelliği tarafından belirtilen değerden daha uzun bir uzunluğa sahip bir değere MaxLength ayarlayabilirsiniz. Bu özellik yalnızca çalışma zamanında denetime girilen metni etkiler.

Ayrıca bkz.

• MaxLength