RichTextBox.MaxLength 속성

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

Source:

RichTextBox.cs

사용자가 서식 있는 텍스트 상자 컨트롤에 입력하거나 붙여넣을 수 있는 최대 문자 수를 가져오거나 설정합니다.

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

속성 값

Int32

컨트롤에 입력할 수 있는 문자 수입니다. 기본값은 Int32.MaxValue입니다.

예외

ArgumentException

속성에 할당된 값이 0보다 작습니다.

예제

다음 코드 예제에서는 컨트롤에 할당되는 텍스트가 MaxLength 속성에 할당된 MaxLength 값보다 큰지 확인하기 위해 RichTextBox 속성을 사용하는 방법을 보여 줍니다. 텍스트가 크지 않으면 이 예제에서는 속성을 사용하여 SelectedText 텍스트를 컨트롤에 할당합니다. 이 예제에서는 명명richTextBox1된 컨트롤이 RichTextBox 폼에 추가되고 예제의 메서드가 컨트롤에 붙여 넣을 매개 변수에 제공된 텍스트를 사용하여 호출되어야 합니다. 또한 이 예제에서는 텍스트 입력을 MaxLength 제한하기 위해 속성을 값으로 RichTextBox설정해야 합니다.

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

설명

이 속성을 0으로 설정하면 컨트롤에 입력할 수 있는 텍스트의 최대 길이는 64KB 문자입니다. 이 속성은 일반적으로 서식 있는 텍스트 형식 (RTF) 텍스트의 한 줄을 표시 하는 데 사용 되는 경우에 RichTextBox 사용 됩니다. 이 속성을 사용 하 여 우편 번호 및 전화 번호와 같은 값에 대 한 컨트롤에 입력 된 텍스트의 길이 제한 하거나 데이터를 데이터베이스에 입력할 때 입력 된 텍스트의 길이 제한할 수 있습니다. 컨트롤에 입력한 텍스트를 데이터베이스에 있는 해당 필드의 최대 길이로 제한할 수 있습니다.

메모

코드에서 속성 값을 Text 속성에서 지정 MaxLength 한 값보다 긴 값으로 설정할 수 있습니다. 이 속성은 런타임에 컨트롤에 입력한 텍스트에만 영향을 줍니다.

추가 정보

• MaxLength