String.Remove Method (Int32)
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Deletes all the characters from this string beginning at a specified position and continuing through the last position.
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 without the removed characters.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | startIndex is less than zero. -or- startIndex specifies a position that is not within this string. |
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 code 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 Example { public static void Demo(System.Windows.Controls.TextBlock outputBlock) { string s = "abc---def"; // outputBlock.Text += "Index: 012345678" + "\n"; outputBlock.Text += String.Format("1) {0}", s) + "\n"; outputBlock.Text += String.Format("2) {0}", s.Remove(3)) + "\n"; outputBlock.Text += String.Format("3) {0}", s.Remove(3, 3)) + "\n"; } } /* This example produces the following results: Index: 012345678 1) abc---def 2) abc 3) abcdef */
Note: