String.Replace Method (String, String)
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Returns a new string in which all occurrences of a specified string in the current string are replaced with another specified string.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- oldValue
- Type: System.String
A string to be replaced.
- newValue
- Type: System.String
A string to replace all occurrences of oldValue.
Return Value
Type: System.StringA string that is equivalent to the current string except that all instances of oldValue are replaced with newValue.
| Exception | Condition |
|---|---|
| ArgumentNullException | oldValue is null. |
| ArgumentException | oldValue is the empty string (""). |
If newValue is null, all occurrences of oldValue are removed.
Note: |
|---|
This method does not modify the value of the current instance. Instead, it returns a new string in which all occurrences of oldValue are replaced by newValue. |
This method performs an ordinal (case-sensitive and culture-insensitive) search to find oldValue.
The following example demonstrates how you can use the Replace method to correct a spelling error.
using System; public class Example { public static void Demo(System.Windows.Controls.TextBlock outputBlock) { string errString = "This docment uses 3 other docments to docment the docmentation"; outputBlock.Text += String.Format("The original string is:{0}'{1}'{0}", "\n", errString) + "\n"; // Correct the spelling of "document". string correctString = errString.Replace("docment", "document"); outputBlock.Text += String.Format("After correcting the string, the result is:{0}'{1}'", "\n", correctString) + "\n"; } } // // This code example produces the following output: // // The original string is: // 'This docment uses 3 other docments to docment the docmentation' // // After correcting the string, the result is: // 'This document uses 3 other documents to document the documentation' //
Note: