String::Remove Method (Int32, Int32)
Returns a new string in which a specified number of characters in the current instance beginning at a specified position have been deleted.
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::String^A new string that is equivalent to this instance except for the removed 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 example demonstrates how you can remove the middle name from a complete name.
using namespace System; int main() { String^ name = "Michelle Violet Banks"; Console::WriteLine( "The entire name is '{0}'", name ); // 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 ); Console::WriteLine( "After removing the middle name, we are left with '{0}'", name ); } } // The example displays the following output: // The entire name is 'Michelle Violet Banks' // After removing the middle name, we are left with 'Michelle Banks'
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
