This documentation is archived and is not being maintained.

StringBuilder.Append Method (Char)

Appends the string representation of a specified Unicode character to the end of this instance.

Namespace: System.Text
Assembly: mscorlib (in mscorlib.dll)

public:
StringBuilder^ Append (
	wchar_t value
)
public StringBuilder Append (
	char value
)
public function Append (
	value : char
) : StringBuilder
Not applicable.

Parameters

value

The Unicode character to append.

Return Value

A reference to this instance after the append operation has completed.

Exception typeCondition

ArgumentOutOfRangeException

Enlarging the value of this instance would exceed MaxCapacity.

The capacity of this instance is adjusted as needed.

The following example demonstrates how to append various data type values to a StringBuilder object.

using namespace System;
using namespace System::Text;
int main()
{
   String^ sep = ", ";
   String^ head = "<<<";
   array<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.
   UInt16 xUInt16 = 8;
   UInt32 xUInt32 = 9;
   UInt64 xUInt64 = 10;
   SByte xSByte = -11;
   
   //
   StringBuilder^ sb = gcnew 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.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

XNA Framework

Supported in: 1.0
Show: