Export (0) Print
Expand All

StringBuilder.Clear Method

Removes all characters from the current StringBuilder instance.

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

public StringBuilder Clear()

Return Value

Type: System.Text.StringBuilder
An object whose Length is 0 (zero).

Clear is a convenience method that is equivalent to setting the Length property of the current instance to 0 (zero).

The following example instantiates a StringBuilder object with a string, calls the Clear method, and then appends a new string.


using System;
using System.Text;

public class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      StringBuilder sb = new StringBuilder("This is a string.");
      outputBlock.Text += String.Format("{0} ({1} characters)", sb.ToString(), sb.Length) + "\n";

      sb.Clear();
      outputBlock.Text += String.Format("{0} ({1} characters)", sb.ToString(), sb.Length) + "\n";

      sb.Append("This is a second string.");
      outputBlock.Text += String.Format("{0} ({1} characters)", sb.ToString(), sb.Length) + "\n";
   }
}
// The example displays the following output:
//       This is a string. (17 characters)
//        (0 characters)
//       This is a second string. (24 characters)


Silverlight

Supported in: 5, 4

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Community Additions

ADD
Show:
© 2014 Microsoft