8.2.2 追加字符串

　　向StringBuilder类的实例追加字符串可以使用Append()、AppendLine()和AppendFormat()方法。上述3个方法都是把指定的对象（如字符、字符串等）追加到StringBuilder类的实例的末尾。如果被追加的对象不是字符串形式，上述方法将该对象自动转换为字符串形式。其中，AppendLine()方法可以追加一个换行符号；AppendFormat()方法还可以设置追加字符串的格式。

Append()方法的重载方法比较多，共有19种，具体说明如下：

      Append(bool value)，追加指定布尔值的字符串形式，value参数表示追加的布尔值；

      Append(byte value)，追加指定8位无符号整数的字符串形式，value参数表示追加的8位无符号整数；

      Append(char value)，追加指定Unicode字符的字符串形式，value参数表示追加的Unicode字符；

      Append(char[] value)，追加指定字符数组的字符串形式，value参数表示追加的字符数组；

      Append(decimal value)，追加指定十进制数的字符串形式，value参数表示追加的十进制数；

      Append(double value)，追加指定双精度浮点数的字符串形式，value参数表示追加的双精度浮点数；

      Append(short value)，追加指定16位有符号整数的字符串形式，value参数表示追加的16位有符号整数；

      Append(int value)，追加指定32位有符号整数的字符串形式，value参数表示追加的32位有符号整数；

      Append(long value)，追加指定64位有符号整数的字符串形式，value参数表示追加的64位有符号整数；

      Append(Object value)，追加指定对象的字符串形式，value参数表示追加的对象；

      Append(sbyte value)，追加指定8位有符号整数的字符串形式，value参数表示追加的8位有符号整数；

      Append(float value)，追加指定单精度浮点数的字符串形式，value参数表示追加的单精度浮点数；

      Append(string value)，追加指定字符串，value参数表示追加的字符串；

      Append(ushort value)，追加指定16位无符号整数的字符串形式，value参数表示追加的16位无符号整数；

      Append(uint value)，追加指定32位无符号整数的字符串形式，value参数表示追加的32位无符号整数；

      Append(ulong value)，追加指定64位无符号整数的字符串形式，value参数表示追加的64位无符号整数；

      Append(char value,int repeatCount)，追加指定字符的字符串形式，value参数表示追加的字符，repeatCount参数表示追加value参数的次数；

      Append(char[] value,int startIndex,int charCount)，追加指定字符数组的字符串形式，value参数表示追加的字符数组，startIndex参数表示value参数中的起始位置，charCount参数表示要追加的字符的数量；

      Append(string value,int startIndex,int count)，追加指定的字符串，value参数表示追加的字符串，startIndex参数表示value参数中的起始位置，count参数表示要追加的字符的数量。

　　AppendFormat()方法在向StringBuilder类的实例追加内容时，可以指定内容的格式化字符串。该方法存在5种重载方式，具体说明如下：

      AppendFormat(string format,Object arg0)，追加一个格式化对象；

      AppendFormat(string format,params Object[] args)，追加格式化的对象数组；

      AppendFormat(IFormatProvider provider,string format,params Object[] args)，追加格式化的动态对象数组；

      AppendFormat(string format,Object arg0,Object arg1)，追加2个格式化对象；

      AppendFormat(string format,Object arg0,Object arg1,Object arg2)，追加3个格式化对象。

　　其中，format参数指定格式化字符串；arg0、arg1、arg2参数都表示追加的对象；args表示追加的对象数组；provider参数指定format参数中格式设置规范的解释方式。

　　AppendLine()方法可以向StringBuilder类的实例追加换行符号，并且该换行符号追加在实例的末尾。该方法存在2种重载方式，具体说明如下：

      AppendLine()，追加一个换行符号；

      AppendLine(string value)，追加一个字符串（由value参数指定），并在末尾追加一个换行符号。

　　下面的代码使用了Append()、AppendLine()、AppendFormat()方法向StringBuilder类的实例sb追加了变量str1、变量str2、“----|----”、当前时间的格式化字符串、换行符号、“----结束----”、“New Line...”等字符串。最后，AppendString(string str1,string str2)函数返回实例sb的字符串形式。

/// <summary>

/// 追加字符串

/// </summary>

/// <param name="str1">参数1</param>

/// <param name="str2">参数2</param>

/// <returns></returns>

private string AppendString(string str1,string str2)

{

StringBuilder sb = new StringBuilder();

///追加字符串

sb.Append(str1);

sb.Append("----|----");

sb.Append(str2);

///追加当前日期，并格式化

sb.AppendFormat("{0:d}",DateTime.Now);

///追加换行符

sb.AppendLine();

///追加结束行

sb.AppendLine("----结束----");

///追加新行

sb.Append("New Line...");

///返回一个String对象

return sb.ToString().Replace("/n","<br />");

}