RichTextBox.MaxLength プロパティ

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

ユーザーがリッチ テキスト ボックス コントロールに入力または貼り付けできる最大文字数を取得または設定します。

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 使用して、コントロールに割り当てられているテキストがプロパティに RichTextBox 割り当てられた値よりも大きいかどうかを判断する方法を MaxLength 示します。 テキストが大きくない場合、この例では プロパティを SelectedText 使用してテキストをコントロールに割り当てます。 この例では、 という名前richTextBox1のRichTextBoxコントロールがフォームに追加され、この例のメソッドが、コントロールに貼り付けるパラメーターにテキストを指定して呼び出される必要があります。 この例では、 へのテキスト入力RichTextBoxをMaxLength制限するために、 プロパティが 値に設定されている必要もあります。

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 に設定すると、コントロールに入力できるテキストの最大長は 64 KB です。 このプロパティは、通常、 を使用して 1 行のリッチ テキスト形式 (RTF) テキストを表示する場合 RichTextBox に使用されます。 このプロパティを使用すると、郵便番号や電話番号などの値に対してコントロールに入力されるテキストの長さを制限したり、データベースにデータを入力するときに入力するテキストの長さを制限したりできます。 コントロールに入力されたテキストを、データベース内の対応するフィールドの最大長に制限できます。

注意

コードでは、 プロパティの値を Text 、 プロパティで指定された値より長い値に MaxLength 設定できます。 このプロパティは、実行時にコントロールに入力されたテキストにのみ影響します。

こちらもご覧ください

• MaxLength