StringBuilder.Remove(Int32, Int32) Metoda

Definicja

Przestrzeń nazw:

System.Text

Zestawy:

netstandard.dll, System.Runtime.dll

Źródło:

StringBuilder.cs

Usuwa określony zakres znaków z tego wystąpienia.

public:
 System::Text::StringBuilder ^ Remove(int startIndex, int length);

public System.Text.StringBuilder Remove(int startIndex, int length);

member this.Remove : int * int -> System.Text.StringBuilder

Public Function Remove (startIndex As Integer, length As Integer) As StringBuilder

Parametry

startIndex

Int32

Położenie na podstawie zera w tym wystąpieniu, w którym rozpoczyna się usuwanie.

length

Int32

Liczba znaków do usunięcia.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji akcyzowej.

Wyjątki

ArgumentOutOfRangeException

Jeśli startIndex wartość lub length jest mniejsza niż zero lub startIndex + length jest większa niż długość tego wystąpienia.

Przykłady

W poniższym przykładzie przedstawiono metodę Remove .

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.

*/

open System.Text

let rule1 = "0----+----1----+----2----+----3----+----4---"
let rule2 = "01234567890123456789012345678901234567890123"
let str = "The quick brown fox jumps over the lazy dog."
let sb = StringBuilder str

printfn "StringBuilder.Remove method\n"
printfn "Original value:"
printfn $"{rule1}"
printfn $"{rule2}"
printfn $"{sb}\n"

sb.Remove(10, 6) |> ignore // Remove "brown "

printfn "New value:"
printfn $"{rule1}"
printfn $"{rule2}"
printfn $"{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.

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
End Class
'
'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.
'

Uwagi

Bieżąca metoda usuwa określony zakres znaków z bieżącego wystąpienia. Znaki w lokalizacji (startIndex + length) są przenoszone do startIndexelementu , a wartość ciągu bieżącego wystąpienia jest skracana przez lengthwartość . Nie ma to wpływu na pojemność bieżącego wystąpienia.

Note

Metoda Remove modyfikuje wartość bieżącego StringBuilder wystąpienia i zwraca to wystąpienie. Nie tworzy i nie zwraca nowego StringBuilder obiektu.

Zobacz też

• Replace(String, String)