StringBuilder.Append Method (Char[], Int32, Int32)
.NET Framework 3.0
Appends the string representation of a specified subarray of Unicode characters to the end of this instance.
Namespace: System.Text
Assembly: mscorlib (in mscorlib.dll)
Assembly: mscorlib (in mscorlib.dll)
public StringBuilder Append ( char[] value, int startIndex, int charCount )
public function Append ( value : char[], startIndex : int, charCount : int ) : StringBuilder
Not applicable.
Parameters
- value
A character array.
- startIndex
The starting position in value.
- charCount
The number of characters to append.
Return Value
A reference to this instance after the append operation has completed.| Exception type | Condition |
|---|---|
| value is a null reference (Nothing in Visual Basic), and startIndex and charCount are not zero. | |
| charCount is less than zero. -or- startIndex is less than zero. -or- startIndex + charCount is less than the length of value. -or- Enlarging the value of this instance would exceed MaxCapacity. |
The following example demonstrates how to append various data type values to a StringBuilder object.
using System; using System.Text; class Sample { public static void Main() { string sep = ", "; string head = "<<<"; char[] tail = {'>', '>', '>'}; char dash = '-'; Object obj = 0; bool xBool = true; byte xByte = 1; short xInt16 = 2; int xInt32 = 3; long xInt64 = 4; Decimal xDecimal = 5; float xSingle = 6.6F; double xDouble = 7.7; // The following types are not CLS-compliant. ushort xUInt16 = 8; uint xUInt32 = 9; ulong xUInt64 = 10; sbyte xSByte = -11; // StringBuilder sb = new StringBuilder(); sb = sb.Append(head); // <<< sb = sb.Append(head, 2, 1); // <<<< sb = sb.Append(dash); // <<<<- sb = sb.Append(dash).Append(dash); // <<<<--- sb = sb.Append(xBool).Append(sep); sb = sb.Append(obj).Append(sep).Append(xByte).Append(sep); sb = sb.Append(xInt16); sb = sb.Append(sep); sb = sb.Append(xInt32); sb = sb.Append(sep); sb = sb.Append(xInt64); sb = sb.Append(sep); sb = sb.Append(xDecimal).Append(sep); sb = sb.Append(xSingle).Append(sep).Append(xDouble).Append(sep); // The following Append methods are not CLS-compliant. sb = sb.Append(xUInt16).Append(sep); sb = sb.Append(xUInt32).Append(sep).Append(xUInt64).Append(sep); sb = sb.Append(xSByte); // sb = sb.Append(dash, 3); // --- sb = sb.Append(tail); // --->>> sb = sb.Append(tail, 2, 1); // --->>>> String str = sb.ToString(); Console.WriteLine("The appended string is:"); Console.WriteLine(str); } } /* This example produces the following results: The appended string is: <<<<---True, 0, 1, 2, 3, 4, 5, 6.6, 7.7, 8, 9, 10, -11--->>>> */
// This example demonstrates StringBuilder.Append()
import System.*;
import System.Text.*;
class Sample
{
public static void main(String[] args)
{
String sep = ", ";
String head = "<<<";
char tail[] = { '>', '>', '>' };
char dash = '-';
Object obj = new Integer(0);
boolean xBool = true;
ubyte xByte = 1;
short xInt16 = 2;
int xInt32 = 3;
long xInt64 = 4;
Decimal xDecimal = new Decimal(5);
float xSingle = 6.6f;
double xDouble = 7.7;
// The following types are not CLS-compliant.
int xUInt16 = 8;
int xUInt32 = 9;
long xUInt64 = 10;
byte xSByte = -11;
//
StringBuilder sb = new StringBuilder();
sb = sb.Append(head); // <<<
sb = sb.Append(head, 2, 1); // <<<<
sb = sb.Append(dash); // <<<<-
sb = sb.Append(dash).Append(dash); // <<<<---
sb = sb.Append(xBool).Append(sep);
sb = sb.Append(obj).Append(sep).Append(xByte).Append(sep);
sb = sb.Append(xInt16);
sb = sb.Append(sep);
sb = sb.Append(xInt32);
sb = sb.Append(sep);
sb = sb.Append(xInt64);
sb = sb.Append(sep);
sb = sb.Append(xDecimal).Append(sep);
sb = sb.Append(xSingle).Append(sep).Append(xDouble).Append(sep);
// The following Append methods are not CLS-compliant.
sb = sb.Append(xUInt16).Append(sep);
sb = sb.Append(xUInt32).Append(sep).Append(xUInt64).Append(sep);
sb = sb.Append(xSByte);
//
sb = sb.Append(dash, 3); // ---
sb = sb.Append(tail); // --->>>
sb = sb.Append(tail, 2, 1); // --->>>>
String str = sb.ToString();
Console.WriteLine("The appended string is:");
Console.WriteLine(str);
} //main
} //Sample
/*
This example produces the following results:
The appended string is:
<<<<---True, 0, 1, 2, 3, 4, 5, 6.6, 7.7, 8, 9, 10, -11--->>>>
*/
Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.