String.Remove Method (Int32, Int32)
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Deletes a specified number of characters from this instance beginning at a specified position.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- startIndex
- Type: System.Int32
The zero-based position to begin deleting characters.
- count
- Type: System.Int32
The number of characters to delete.
Return Value
Type: System.StringA new string that is equivalent to this instance less count number of characters.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | Either startIndex or count is less than zero. -or- startIndex plus count specify a position outside this instance. |
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 the number of characters specified by the count parameter have been removed. The characters are removed at the position specified by startIndex. |
The following code example demonstrates how you can remove the middle name from a complete name.
using System; public class Example { public static void Demo(System.Windows.Controls.TextBlock outputBlock) { string name = "Michelle Violet Banks"; outputBlock.Text += String.Format("The entire name is '{0}'", name) + "\n"; // remove the middle name, identified by finding the spaces in the middle of the name... int foundS1 = name.IndexOf(" "); int foundS2 = name.IndexOf(" ", foundS1 + 1); if (foundS1 != foundS2 && foundS1 >= 0) { name = name.Remove(foundS1 + 1, foundS2 - foundS1); outputBlock.Text += String.Format("After removing the middle name, we are left with '{0}'", name) + "\n"; } } }
Note: