StringBuilder.Remove-Methode

Artikel
08/20/2007

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.

Freigeben über

StringBuilder.Remove-Methode

Syntax

Parameter

Rückgabewert

Ausnahmen

Hinweise

Beispiel

Plattformen

Versionsinformationen

.NET Framework

.NET Compact Framework

Siehe auch

Referenz

Zusätzliche Ressourcen