StringBuilder.Clear Метод

Определение

Пространство имен:

System.Text

Сборки:

netstandard.dll, System.Runtime.dll

Исходный код:

StringBuilder.cs

Удаляет все символы из текущего StringBuilder экземпляра.

public:
 System::Text::StringBuilder ^ Clear();

public System.Text.StringBuilder Clear();

member this.Clear : unit -> System.Text.StringBuilder

Public Function Clear () As StringBuilder

Возвращаемое значение

StringBuilder

Объект, значение которого Length равно 0 (ноль).

Примеры

В следующем примере создается экземпляр StringBuilder объекта со строкой, вызывается Clear метод, а затем добавляется новая строка.

using System;
using System.Text;

public class Class1
{
   public static void Main()
   {
      StringBuilder sb = new StringBuilder("This is a string.");
      Console.WriteLine("{0} ({1} characters)", sb.ToString(), sb.Length);
      
      sb.Clear();
      Console.WriteLine("{0} ({1} characters)", sb.ToString(), sb.Length);

      sb.Append("This is a second string.");
      Console.WriteLine("{0} ({1} characters)", sb.ToString(), sb.Length);
   }
}
// The example displays the following output:
//       This is a string. (17 characters)
//        (0 characters)
//       This is a second string. (24 characters)

open System.Text

let sb = StringBuilder "This is a string."
printfn $"{sb} ({sb.Length} characters)"

sb.Clear() |> ignore
printfn $"{sb} ({sb.Length} characters)"

sb.Append "This is a second string." |> ignore
printfn $"{sb} ({sb.Length} characters)"

// The example displays the following output:
//       This is a string. (17 characters)
//        (0 characters)
//       This is a second string. (24 characters)

Imports System.Text

Module Example
   Public Sub Main()
      Dim sb As New StringBuilder("This is a string.")
      Console.WriteLine("{0} ({1} characters)", sb.ToString(), sb.Length)
      
      sb.Clear()
      Console.WriteLine("{0} ({1} characters)", sb.ToString(), sb.Length)

      sb.Append("This is a second string.")
      Console.WriteLine("{0} ({1} characters)", sb.ToString(), sb.Length)
   End Sub            
End Module
' The example displays the following output:
'       This is a string. (17 characters)
'        (0 characters)
'       This is a second string. (24 characters)

Комментарии

Clear — это удобный метод, эквивалентный настройке Length свойства текущего экземпляра равным 0 (ноль).