Mono Class Library: System.Text.StringBuilder Overview | Members

System.Text.StringBuilder.Replace Method

Replaces all instances of a specified string in a specified range with another specified string.

public StringBuilder Replace (string oldValue, string newValue, int startIndex, int count)

Parameters

oldValue
A string containing the string value to replace.
newValue
A string containing the string value with which to replace oldValue. Can be a null reference.
startIndex
A int containing the location from which to start replacing oldValue.
count
A int containing the length of the range in which to replace oldValue.

Returns

The current instance after substitution has occurred.

Exceptions

TypeReason
ArgumentNullExceptionoldValue is a null reference.
ArgumentOutOfRangeException

startIndex or count is less than zero.

-or-

The sum of startIndex and count is greater than the length of the current instance.

ArgumentExceptionThe length of oldvalue is zero.

Remarks

This method substitutes each occurrence of oldValue in the specified range of the current instance with newValue.

Note: If newValue is null , instances of oldValue are removed.

This method is case-sensitive.

Requirements

Namespace: System.Text
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0