Share via

NamedRange.Replace 方法

  • 發行項

以新的字串取代 NamedRange 控制項中指定的字元。

命名空間：  Microsoft.Office.Tools.Excel
組件：  Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)

語法

'宣告
Function Replace ( _
    What As Object, _
    Replacement As Object, _
    LookAt As Object, _
    SearchOrder As Object, _
    MatchCase As Object, _
    MatchByte As Object, _
    SearchFormat As Object, _
    ReplaceFormat As Object _
) As Boolean

bool Replace(
    Object What,
    Object Replacement,
    Object LookAt,
    Object SearchOrder,
    Object MatchCase,
    Object MatchByte,
    Object SearchFormat,
    Object ReplaceFormat
)

參數

  • What
    型別：System.Object
    要 Microsoft Office Excel 搜尋的字串。
  • MatchCase
    型別：System.Object
    true 表示搜尋時區分大小寫。
  • MatchByte
    型別：System.Object
    只有當您在 Excel 中選取或安裝雙位元語言支援時，才能使用這個引數。true 表示只會將雙位元組字元與雙位元組字元比對，否則為 false，表示將雙位元組字元與其對等的單位元組字元比對。

傳回值

型別：System.Boolean
如果指定的字元在 NamedRange 控制項的儲存格中則為 true，否則為 false。

備註

使用這個方法不會變更選取範圍或現用儲存格。

每次使用這個方法時，會儲存 LookAt、SearchOrder、MatchCase 和 MatchByte 的設定。 如果沒有為這些引數指定值，下次您呼叫這個方法時便會使用已儲存的值。 設定這些引數會變更 [尋找] 對話方塊中的設定，而變更 [尋找] 對話方塊中的設定會變更您省略引數時使用的儲存值。 若要避免發生問題，每次使用這個方法時應明確設定這些引數。

選擇性參數

如需選擇性參數的詳細資訊，請參閱Office 方案中的選擇性參數。

範例

下列程式碼範例會將 NamedRange 控制項中儲存格的值設定為字串 "This is a sentence."，然後使用 Replace 方法將子字串 "a" 取代為 "my"。

這是示範文件層級自訂的範例。

    Private Sub ReplaceValue()
        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1"), _
            "namedRange1")

        namedRange1.Value2 = "This is a sentence."
        namedRange1.Replace("a", "my", Excel.XlLookAt.xlPart, _
            Excel.XlSearchOrder.xlByColumns, False, , , )
    End Sub


private void ReplaceValue()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1"],
        "namedRange1");

    namedRange1.Value2 = "This is a sentence.";
    namedRange1.Replace("a", "my", Excel.XlLookAt.xlPart,
        Excel.XlSearchOrder.xlByColumns, false);
}

.NET Framework 安全性

請參閱

參考

NamedRange 介面

Microsoft.Office.Tools.Excel 命名空間