StringBuilder.ToString Method

Definition

Converts the value of a StringBuilder to a String.

Overloads

ToString()

Converts the value of this instance to a String.

ToString(Int32, Int32)

Converts the value of a substring of this instance to a String.

ToString()

Converts the value of this instance to a String.

public override string ToString ();
Returns

A string whose value is the same as this instance.

Examples

The following example demonstrates calling the ToString method. This example is part of a larger example provided for the StringBuilder class.

// Display the number of characters in the StringBuilder
// and its string.
Console::WriteLine("{0} chars: {1}", sb->Length, sb->ToString());
// Display the number of characters in the StringBuilder and its string.
Console.WriteLine("{0} chars: {1}", sb.Length, sb.ToString());
' Display the number of characters in the StringBuilder and its string.
Console.WriteLine("{0} chars: {1}", sb.Length, sb.ToString())

Remarks

You must call the ToString method to convert the StringBuilder object to a String object before you can pass the string represented by the StringBuilder object to a method that has a String parameter or display it in the user interface.

ToString(Int32, Int32)

Converts the value of a substring of this instance to a String.

public string ToString (int startIndex, int length);
Parameters
startIndex
Int32

The starting position of the substring in this instance.

length
Int32

The length of the substring.

Returns

A string whose value is the same as the specified substring of this instance.

Exceptions

startIndex or length is less than zero.

-or-

The sum of startIndex and length is greater than the length of the current instance.

Remarks

You must call the ToString method to convert the StringBuilder object to a String object before you can pass the string represented by the StringBuilder object to a method that has a String parameter or display it in the user interface.

Applies to