String.Remove Method (Int32)
Returns a new string in which all the characters in the current instance, beginning at a specified position and continuing through the last position, have been deleted.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Parameters
- startIndex
- Type: System.Int32
The zero-based position to begin deleting characters.
Return Value
Type: System.StringA new string that is equivalent to this string except for the removed characters.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | startIndex is less than zero. -or- startIndex specifies a position that is not within this string. |
In the .NET Framework, strings are zero-based. The value of the startIndex parameter can range from zero to one less than the length of the string instance.
 Note |
|---|
This method does not modify the value of the current instance. Instead, it returns a new string in which all characters from position startIndex to the end of the original string have been removed. |
The following example demonstrates the Remove method. The next-to-last case removes all text starting from the specified index through the end of the string. The last case removes three characters starting from the specified index.
// This example demonstrates the String.Remove() method. using System; class Sample { public static void Main() { string s = "abc---def"; // Console.WriteLine("Index: 012345678"); Console.WriteLine("1) {0}", s); Console.WriteLine("2) {0}", s.Remove(3)); Console.WriteLine("3) {0}", s.Remove(3, 3)); } } /* This example produces the following results: Index: 012345678 1) abc---def 2) abc 3) abcdef */
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
