StringBuilder.Remove-Methode

Entfernt den angegebenen Bereich von Zeichen aus dieser Instanz.

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

Syntax

'Declaration
Public Function Remove ( _
    startIndex As Integer, _
    length As Integer _
) As StringBuilder
'Usage
Dim instance As StringBuilder
Dim startIndex As Integer
Dim length As Integer
Dim returnValue As StringBuilder

returnValue = instance.Remove(startIndex, length)

public StringBuilder Remove (
    int startIndex,
    int length
)

public:
StringBuilder^ Remove (
    int startIndex, 
    int length
)

public StringBuilder Remove (
    int startIndex, 
    int length
)

public function Remove (
    startIndex : int, 
    length : int
) : StringBuilder

Parameter

• startIndex
  Die Position in dieser Instanz, an der das Entfernen beginnt.

• length
  Die Anzahl der zu entfernenden Zeichen.

Rückgabewert

Ein Verweis auf diese Instanz, nachdem der Ausschneidevorgang abgeschlossen wurde.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentOutOfRangeException	startIndex oder length ist kleiner als 0 (null), oder startIndex + length ist größer als die Länge dieser Instanz.

Hinweise

Die aktuelle Methode entfernt den angegebenen Bereich von Zeichen aus der aktuellen Instanz. Die Zeichen an (startIndex + length) werden zu startIndex verschoben, und der Zeichenfolgenwert der aktuellen Instanz wird um length gekürzt. Die Kapazität der aktuellen Instanz ist hiervon nicht betroffen.

Beispiel

Im folgenden Codebeispiel wird die Remove-Methode veranschaulicht.

Imports System
Imports System.Text

Class Sample
   Public Shared Sub Main()
      Dim rule1 As String = "0----+----1----+----2----+----3----+----4---"
      Dim rule2 As String = "01234567890123456789012345678901234567890123"
      Dim str As String   = "The quick brown fox jumps over the lazy dog."
      Dim sb As New StringBuilder(str)
      
      Console.WriteLine()
      Console.WriteLine("StringBuilder.Remove method")
      Console.WriteLine()
      Console.WriteLine("Original value:")
      Console.WriteLine(rule1)
      Console.WriteLine(rule2)
      Console.WriteLine("{0}", sb.ToString())
      Console.WriteLine()
      
      sb.Remove(10, 6) ' Remove "brown "

      Console.WriteLine("New value:")
      Console.WriteLine(rule1)
      Console.WriteLine(rule2)
      Console.WriteLine("{0}", sb.ToString())
   End Sub 'Main
End Class 'Sample
'
'This example produces the following results:
'
'StringBuilder.Remove method
'
'Original value:
'0----+----1----+----2----+----3----+----4---
'01234567890123456789012345678901234567890123
'The quick brown fox jumps over the lazy dog.
'
'New value:
'0----+----1----+----2----+----3----+----4---
'01234567890123456789012345678901234567890123
'The quick fox jumps over the lazy dog.
'

using System;
using System.Text;

class Sample 
{
    public static void Main() 
    {
    string rule1 = "0----+----1----+----2----+----3----+----4---";
    string rule2 = "01234567890123456789012345678901234567890123";
    string str =   "The quick brown fox jumps over the lazy dog.";
    StringBuilder sb = new StringBuilder(str);

    Console.WriteLine();
    Console.WriteLine("StringBuilder.Remove method");
    Console.WriteLine();
    Console.WriteLine("Original value:");
    Console.WriteLine(rule1);
    Console.WriteLine(rule2);
    Console.WriteLine("{0}", sb.ToString());
    Console.WriteLine();

    sb.Remove(10, 6); // Remove "brown "

    Console.WriteLine("New value:");
    Console.WriteLine(rule1);
    Console.WriteLine(rule2);
    Console.WriteLine("{0}", sb.ToString());
    }
}
/*
This example produces the following results:

StringBuilder.Remove method

Original value:
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown fox jumps over the lazy dog.

New value:
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick fox jumps over the lazy dog.

*/

using namespace System;
using namespace System::Text;
int main()
{
   String^ rule1 = "0----+----1----+----2----+----3----+----4---";
   String^ rule2 = "01234567890123456789012345678901234567890123";
   String^ str = "The quick brown fox jumps over the lazy dog.";
   StringBuilder^ sb = gcnew StringBuilder( str );
   Console::WriteLine();
   Console::WriteLine( "StringBuilder.Remove method" );
   Console::WriteLine();
   Console::WriteLine( "Original value:" );
   Console::WriteLine( rule1 );
   Console::WriteLine( rule2 );
   Console::WriteLine( "{0}", sb );
   Console::WriteLine();
   sb->Remove( 10, 6 ); // Remove "brown "
   Console::WriteLine( "New value:" );
   Console::WriteLine( rule1 );
   Console::WriteLine( rule2 );
   Console::WriteLine( "{0}", sb );
}

/*
This example produces the following results:

StringBuilder.Remove method

Original value:
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown fox jumps over the lazy dog.

New value:
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick fox jumps over the lazy dog.

*/

// This example demonstrates StringBuilder.Remove()
import System.*;
import System.Text.*;

class Sample
{
    public static void main(String[] args)
    {
        String rule1 = "0----+----1----+----2----+----3----+----4---";
        String rule2 = "01234567890123456789012345678901234567890123";
        String str = "The quick brown fox jumps over the lazy dog.";
        StringBuilder sb = new StringBuilder(str);

        Console.WriteLine();
        Console.WriteLine("StringBuilder.Remove method");
        Console.WriteLine();
        Console.WriteLine("Original value:");
        Console.WriteLine(rule1);
        Console.WriteLine(rule2);
        Console.WriteLine("{0}", sb.ToString());
        Console.WriteLine();

        sb.Remove(10, 6); // Remove "brown "
        Console.WriteLine("New value:");
        Console.WriteLine(rule1);
        Console.WriteLine(rule2);
        Console.WriteLine("{0}", sb.ToString());
    } //main
} //Sample
/*
This example produces the following results:

StringBuilder.Remove method

Original value:
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown fox jumps over the lazy dog.

New value:
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick fox jumps over the lazy dog.

*/

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

StringBuilder-Klasse
StringBuilder-Member
System.Text-Namespace
Replace