Strings.Replace(String, String, String, Int32, Int32, CompareMethod) 方法

定義

命名空間:

Microsoft.VisualBasic

組件:

Microsoft.VisualBasic.Core.dll

來源:

Strings.vb

傳回字串，其中的指定之子字串已經被另一個子字串取代了指定的次數。

public static string? Replace (string? Expression, string? Find, string? Replacement, int Start = 1, int Count = -1, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);

static member Replace : string * string * string * int * int * Microsoft.VisualBasic.CompareMethod -> string

Public Function Replace (Expression As String, Find As String, Replacement As String, Optional Start As Integer = 1, Optional Count As Integer = -1, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As String

參數

Expression

String

必要。 字串運算式，包含要取代的子字串。

Find

String

必要。 正在搜尋的子字串。

Replacement

String

必要。 取代子字串。

Start

Int32

選擇性。 Expression 內用於取代的子字串的開始位置。 Replace 的傳回值是以 Start 開頭且具有適當替代的字串。 如果省略，則假設為 1。

Count

Int32

選擇性。 要執行的子字串替代次數。 如果省略，則預設值為 -1，表示「執行所有可能的替代」。

Compare

CompareMethod

選擇性。 數值，表示在評估子字串時要使用的比較類型。 請參閱數值的設定。

傳回

String

下列其中一個值。

如果	Replace 會傳回
Find 的長度為零或 Nothing	Expression 的複本
Replace 的長度為零	Expression 的複本沒有出現 Find
Expression 的長度為零或 Nothing，或 Start 大於 Expression 的長度	Nothing
Count 為 0	Expression 的複本

例外狀況

ArgumentException

Count< -1 或 Start<= 0。

範例

此範例示範 函 Replace 式。

Dim TestString As String = "Shopping List"  
' Returns "Shipping List".  
Dim aString As String = Replace(TestString, "o", "i")  

備註

函式的Replace傳回值是從 所Start指定位置開始的字串，並在字串結尾Expression結束，並以 和 Replace 值所指定的Find替代項目結束。

自 Compare 變數可以有下列值。

常數	描述
Binary	執行二進位比較
Text	執行文字比較

另請參閱

• Filter
• ArgumentException
• 字串操作摘要