Strings.Replace 方法

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

命名空間： Microsoft.VisualBasic
組件： Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
Public Shared Function Replace ( _
    Expression As String, _
    Find As String, _
    Replacement As String, _
    <OptionalAttribute> Optional Start As Integer = 1, _
    <OptionalAttribute> Optional Count As Integer = -1, _
    <OptionalAttribute> Optional Compare As CompareMethod = CompareMethod.Binary _
) As String
'用途
Dim Expression As String
Dim Find As String
Dim Replacement As String
Dim Start As Integer
Dim Count As Integer
Dim Compare As CompareMethod
Dim returnValue As String

returnValue = Strings.Replace(Expression, Find, Replacement, Start, Count, Compare)

public static string Replace (
    string Expression,
    string Find,
    string Replacement,
    [OptionalAttribute] int Start,
    [OptionalAttribute] int Count,
    [OptionalAttribute] CompareMethod Compare
)

public:
static String^ Replace (
    String^ Expression, 
    String^ Find, 
    String^ Replacement, 
    [OptionalAttribute] int Start, 
    [OptionalAttribute] int Count, 
    [OptionalAttribute] CompareMethod Compare
)

public static String Replace (
    String Expression, 
    String Find, 
    String Replacement, 
    /** @attribute OptionalAttribute() */ int Start, 
    /** @attribute OptionalAttribute() */ int Count, 
    /** @attribute OptionalAttribute() */ CompareMethod Compare
)

public static function Replace (
    Expression : String, 
    Find : String, 
    Replacement : String, 
    Start : int, 
    Count : int, 
    Compare : CompareMethod
) : String

參數

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

• Find
  必要項。正在搜尋的子字串。

• Replacement
  必要項。取代子字串。

• Start
  選擇項。Expression 內子字串搜尋開始的位置。如果省略，則假設為 1。

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

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

傳回值

如果 Find 的長度為零或 Nothing, ，則 Replace 會傳回 Expression. 的複本。如果 Replace 的長度為零，則 Replace 會傳回 Expression 的複本，且不會有 Find. 的相符項目。如果 Expression 的長度為零或 Nothing，或是 Start 大於 Expression, 的長度，則 Replace 會傳回 Nothing. 。如果 Count 為 0，則 Replace 會傳回 Expression. 的複本。

備註

如需詳細資訊，請參閱 Visual Basic 的主題 Replace 函式 (Visual Basic)。

Replace 函式的傳回值是一個在 Start 指定之位置上開始的字串，且結束於 Expression 字串的尾端，且會由 Find 和 Replace 值指定替代。

Compare 引數可以具有下列的值。

範例

此範例將示範 Replace 函式。

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

平台

Windows 98、 Windows 2000 SP4、 Windows CE、 Windows Millennium Edition、 Windows Mobile for Pocket PC、 Windows Mobile for Smartphone、 Windows Server 2003、 Windows XP Media Center Edition、 Windows XP Professional x64 Edition、 Windows XP SP2、 Windows XP Starter Edition

.NET Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱系統需求一節的內容。

版本資訊

.NET Framework

支援版本：2.0、1.1、1.0

.NET Compact Framework

支援版本：2.0、1.0

請參閱

參考

Strings 類別
Strings 成員
Microsoft.VisualBasic 命名空間
ArgumentException

其他資源

Replace 函式 (Visual Basic)
字串操作摘要
Filter 函式 (Visual Basic)