This documentation is archived and is not being maintained.

String.Remove Method (Int32, Int32)

Updated: July 2008

Deletes a specified number of characters from this instance beginning at a specified position.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

public function Remove(
	startIndex : int, 
	count : int
) : String


Type: System.Int32

The zero-based position to begin deleting characters.

Type: System.Int32

The number of characters to delete.

Return Value

Type: System.String
A new String that is equivalent to this instance less count number of characters.


Either startIndex or count is less than zero.


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.


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.

No code example is currently available or this language may not be supported.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0




July 2008

Added detail to the Remarks section.

Customer feedback.