StringBuilder.Remove(Int32, Int32) Metódus

Definíció

Névtér:

System.Text

Szerelvények:

netstandard.dll, System.Runtime.dll

Forrás:

StringBuilder.cs

Eltávolítja a megadott karaktertartományt ebből a példányból.

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

Paraméterek

startIndex

Int32

A nulla alapú pozíció ebben a példányban, ahol az eltávolítás megkezdődik.

length

Int32

Az eltávolítandó karakterek száma.

Válaszok

StringBuilder

Hivatkozás erre a példányra a jövedéki művelet befejezése után.

Kivételek

ArgumentOutOfRangeException

Ha startIndex vagy kisebb, mint nulla, vagy lengthstartIndex + nagyobb, mint a példány hossza.length

Példák

Az alábbi példa a metódust Remove mutatja be.

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

Megjegyzések

Az aktuális metódus eltávolítja a megadott karaktertartományt az aktuális példányból. A(z) pontbanstartIndex + length lévő karaktereket a startIndexrendszer áthelyezi, és az aktuális példány sztringértékét rövidíti lengtha rendszer. Az aktuális példány kapacitása nincs hatással.

Note

A Remove metódus módosítja az aktuális StringBuilder példány értékét, és visszaadja az adott példányt. Nem hoz létre és nem ad vissza új StringBuilder objektumot.

Lásd még

• Replace(String, String)