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

显示:
© 2014 Microsoft