|Important||This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer|
Replace Function (Visual Basic)
Returns a string in which a specified substring has been replaced with another substring a specified number of times.
Public Function Replace( ByVal Expression As String, ByVal Find As String, ByVal Replacement As String, Optional ByVal Start As Integer = 1, Optional ByVal Count As Integer = -1, Optional ByVal Compare As CompareMethod = CompareMethod.Binary ) As String
Required. String expression containing substring to replace.
Required. Substring being searched for.
Required. Replacement substring.
Optional. Position within Expression where substring search is to begin. If omitted, 1 is assumed.
Optional. Number of substring substitutions to perform. If omitted, the default value is –1, which means "make all possible substitutions."
Optional. Numeric value indicating the kind of comparison to use when evaluating substrings. See Settings for values.
|Exception type||Error number||Condition|
Count < -1 or Start <= 0.
See the "Error number" column if you are upgrading Visual Basic 6.0 applications that use unstructured error handling. (You can compare the error number against the.) However, when possible, you should consider replacing such error control with .
This example demonstrates the Replace function.
Dim TestString As String = "Shopping List" ' Returns "Shipping List". Dim aString As String = Replace(TestString, "o", "i")
Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)