通过

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。
  • SearchFormat
    类型：System.Object
    该方法的搜索格式。
  • ReplaceFormat
    类型：System.Object
    该方法的替换格式。

返回值

类型：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 命名空间