情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

StringBuilder.Append メソッド (Object)

2013/12/12

指定したオブジェクトの文字列形式をこのインスタンスの末尾に追加します。

Namespace:  System.Text
アセンブリ:  mscorlib (mscorlib.dll 内)

public StringBuilder Append(
	Object value
)

パラメーター

value
型: System.Object
追加するオブジェクト。

戻り値

型: System.Text.StringBuilder
追加操作が完了した後の、このインスタンスへの参照。

例外条件
ArgumentOutOfRangeException

このインスタンスの値を拡大すると、最大容量を超えます。

Append メソッドは、このクラスの既存のインスタンスを変更します。新しいクラス インスタンスは返しません。このため、次の例に示すように、既存の参照についてメソッドまたはプロパティを呼び出すことができ、戻り値を StringBuilder オブジェクトに割り当てる必要はありません。この例では、Dog クラスを定義し、Dog オブジェクトを作成し、Append メソッドに対して 3 つの呼び出しを行って、犬の名前と血統を含む文字列を作成します。


using System;

public class Dog
{
   private string dogBreed;
   private string dogName;

   public Dog(string name, string breed)
   {
      this.dogName = name;
      this.dogBreed = breed;
   }

   public string Breed {
      get { return this.dogBreed; }
   }

   public string Name {
      get { return this.dogName; }
   }

   public override string ToString()
   {
      return this.dogName;
   }
}

public class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      Dog dog1 = new Dog("Yiska", "Alaskan Malamute");
      System.Text.StringBuilder sb = new System.Text.StringBuilder();     
      sb.Append(dog1).Append(", Breed: ").Append(dog1.Breed);  
      outputBlock.Text += sb + Environment.NewLine;
   }
}
// The example displays the following output:
//        Yiska, Breed: Alaskan Malamute


Append メソッドは、Object.ToString メソッドを呼び出して、value の文字列形式を取得します。valuenull の場合、StringBuilder オブジェクトは変更されません。

このインスタンスの容量は、必要に応じて調整されます。

Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示: