StringBuilder.Clear Methode

Referenz

Definition

Namespace:: System.Text

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Entfernt alle Zeichen aus der aktuellen StringBuilder-Instanz.

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

public System.Text.StringBuilder Clear ();

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

Public Function Clear () As StringBuilder

Gibt zurück

StringBuilder

Ein Objekt, dessen Length 0 (null) ist.

Beispiele

Im folgenden Beispiel wird ein StringBuilder -Objekt mit einer Zeichenfolge instanziiert, die Clear -Methode aufruft und dann eine neue Zeichenfolge angefügt.

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)

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)

Hinweise

Clear ist eine praktische Methode, die dem Festlegen der Length -Eigenschaft der aktuellen Instanz auf 0 (null) entspricht.

Gilt für

Freigeben über