정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

StringBuilder.Append 메서드 (Object)

2013-12-13

지정된 개체의 문자열 표현을 이 인스턴스의 끝에 추가합니다.

Namespace:  System.Text
어셈블리:  mscorlib(mscorlib.dll)

public StringBuilder Append(
	Object value
)

매개 변수

value
형식: System.Object
추가할 개체입니다.

반환 값

형식: System.Text.StringBuilder
추가 작업이 완료된 후 이 인스턴스에 대한 참조입니다.

예외조건
ArgumentOutOfRangeException

이 인스턴스의 값이 커지면 최대 용량을 초과할 수 있는 경우

Append 메서드는 이 클래스의 기존 인스턴스를 수정하며, 새 클래스 인스턴스를 반환하지 않습니다. 이로 인해 기존 참조의 메서드 또는 속성을 호출할 수 있으며 다음 예제에서 볼 수 있듯이 StringBuilder 개체에 반환 값을 할당할 필요는 없습니다. Dog 클래스를 정의하고 Dog 개체를 만들며 Append 메서드를 세 번 호출하여 개의 이름과 종이 포함된 문자열을 만듭니다.


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

Windows Phone

표시: