はじめに

TextBoxに新しいテキストを追加したいとき、単純に Text += "..." と書く方法もありますが、
より効率的で安全なのが AppendText() メソッド です。
既存の内容を消さずに末尾に文字列を追加できます。

1. AppendTextメソッドとは？

AppendText(string text) メソッドは、
TextBoxの末尾に指定した文字列を追加する機能を持ちます。
既存のテキストは保持され、追記専用の操作になります。

2. 基本の使い方

コード例

// TextBoxの末尾に文字列を追加
textBox1.AppendText("追加テキスト");

改行を入れたい場合は \r\n を組み合わせます。

textBox1.AppendText("1行目\r\n");
textBox1.AppendText("2行目\r\n");

3. 実用例：ログ表示欄

using System;
using System.Windows.Forms;

namespace AppendTextSample
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();

            // 複数行入力を有効化
            textBoxLog.Multiline = true;
            textBoxLog.ScrollBars = ScrollBars.Vertical;
        }

        private void buttonAdd_Click(object sender, EventArgs e)
        {
            // ログに追記
            textBoxLog.AppendText(DateTime.Now.ToString() + " ボタンが押されました\r\n");
        }
    }
}

このように AppendText() を使うと、ログや履歴のような追記型のテキスト出力が簡単に実現できます。

4. AppendText() と Text += の違い

• AppendText()
  → 末尾に文字を追加するために最適化されている。高速で効率的。
• Text += “…”
  → 内部的に文字列を作り直すため、繰り返し操作が多いと効率が悪い。

5. 注意点

• 追加されるのは常に「末尾」。先頭や途中に挿入する機能はない
• 大量のテキストを追記すると、表示や動作が重くなる場合がある
• スクロールを最新行に追従させたいときは ScrollToCaret() を組み合わせると良い

まとめ

• AppendText() はTextBoxの末尾に文字列を追記するメソッド
• ログや履歴表示に便利
• Text += ... より効率的に動作する

TextBoxを使ったアプリで「情報を順次追加していく」仕組みを作るなら、
AppendText() は必ず覚えておきたい基本メソッドです。

Please follow and like us: