StringBuilder.Replace Method (Char, Char)
.NET Framework 4
Replaces all occurrences of a specified character in this instance with another specified character.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- oldChar
- Type: System.Char
The character to replace.
- newChar
- Type: System.Char
The character that replaces oldChar.
Return Value
Type: System.Text.StringBuilderA reference to this instance with oldChar replaced by newChar.
A StringBuilder with all instances of oldChar replaced with newChar. The size of the StringBuilder is unchanged because characters are only replaced. This method is case-sensitive.
The following example demonstrates the Replace method.
using System; using System.Text; class Sample { public static void Main() { // 0----+----1----+----2----+----3----+----4--- // 01234567890123456789012345678901234567890123 string str = "The quick br!wn d#g jumps #ver the lazy cat."; StringBuilder sb = new StringBuilder(str); Console.WriteLine(); Console.WriteLine("StringBuilder.Replace method"); Console.WriteLine(); Console.WriteLine("Original value:"); Show(sb); sb.Replace('#', '!', 15, 29); // Some '#' -> '!' Show(sb); sb.Replace('!', 'o'); // All '!' -> 'o' Show(sb); sb.Replace("cat", "dog"); // All "cat" -> "dog" Show(sb); sb.Replace("dog", "fox", 15, 20); // Some "dog" -> "fox" Console.WriteLine("Final value:"); Show(sb); } public static void Show(StringBuilder sbs) { string rule1 = "0----+----1----+----2----+----3----+----4---"; string rule2 = "01234567890123456789012345678901234567890123"; Console.WriteLine(rule1); Console.WriteLine(rule2); Console.WriteLine("{0}", sbs.ToString()); Console.WriteLine(); } } /* This example produces the following results: StringBuilder.Replace method Original value: 0----+----1----+----2----+----3----+----4--- 01234567890123456789012345678901234567890123 The quick br!wn d#g jumps #ver the lazy cat. 0----+----1----+----2----+----3----+----4--- 01234567890123456789012345678901234567890123 The quick br!wn d!g jumps !ver the lazy cat. 0----+----1----+----2----+----3----+----4--- 01234567890123456789012345678901234567890123 The quick brown dog jumps over the lazy cat. 0----+----1----+----2----+----3----+----4--- 01234567890123456789012345678901234567890123 The quick brown dog jumps over the lazy dog. Final value: 0----+----1----+----2----+----3----+----4--- 01234567890123456789012345678901234567890123 The quick brown fox jumps over the lazy dog. */
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.