Replace 函式 (Visual Basic)

  • 發行項

更新：2007 年 11 月

在傳回的字串中，其中指定的子字串已被其他子字串取代了有指定次數之多。

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

參數

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

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

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

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

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

  • Compare
    選擇項。數值指示出當評估子字串時要使用哪種比對。請參閱數值的設定。

設定

Compare 引數可以是下列各值。

常數

描述

Binary

執行二進位比對

Text

執行文字比對

傳回值

Replace 會傳回下列值。

如果

Replace 傳回

Find 的長度為零或Nothing

Expression 的複本

Replace 的長度為零

Expression 的複本沒有出現 Find

Expression 的長度為零或 Nothing，或 Start 大於 Expression 的長度

Nothing

Count 為 0

Expression 的複本

例外狀況

例外狀況類型

錯誤代碼

條件

ArgumentException

5

Count < -1 或 Start <= 0。

如果將使用非結構化錯誤處理的 Visual Basic 6.0 應用程式升級，請參閱「錯誤代碼」資料行 (您可以將錯誤代碼與 Number 屬性 (Err 物件) 比對)。但是，請盡可能考慮以 Visual Basic 的結構化例外處理概觀 取代這類錯誤控制項。

備註

Replace 函式的傳回值是開始於 Start 所指定的位置且結束於 Expression 字串的尾端之字串，並依照 Find 和 Replace 值的指定來進行替換。

範例

以下範例將說明如何使用 Replace 函式。

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

需求

命名空間 (Namespace)︰Microsoft.VisualBasic

模組：Strings

組件 (Assembly)：Visual Basic Runtime Library (在 Microsoft.VisualBasic.dll 中)

請參閱

參考

字串操作摘要

Filter 函式 (Visual Basic)

ArgumentException