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. [Edit]

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

Parameters

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

Returns

The current instance after substitution has occurred. [Edit]

Exceptions

TypeReason
ArgumentNullExceptionoldValue is a null reference. [Edit]
ArgumentOutOfRangeException

startIndex or count is less than zero.

-or-

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

[Edit]
ArgumentExceptionThe length of oldvalue is zero. [Edit]

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.

[Edit]

Requirements

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