Replace

Replace(What, Replacement, LookAt, SearchOrder, SearchDirection, MatchCase, ReplaceAll)

Replaces specific information to another one in a range.

Parameters:

Name Type Description
What string | undefined

The data to search for.

Replacement string

The replacement string.

LookAt XlLookAt

Specifies whether the whole search text or any part of the search text is matched.

SearchOrder XlSearchOrder

Range search order - by rows or by columns.

SearchDirection XlSearchDirection

Range search direction - next match or previous match.

MatchCase boolean

Case sensitive or not. The default value is "false".

ReplaceAll boolean

Specifies if all the found data will be replaced or not. The default value is "true".

Returns:

This method doesn't return any data.

Example

Copy code
builder.CreateFile("xlsx");
var oWorksheet = Api.GetActiveSheet();
oWorksheet.GetRange("B1").SetValue(2014);
oWorksheet.GetRange("C1").SetValue(2015);
oWorksheet.GetRange("D1").SetValue(2016);
oWorksheet.GetRange("A2").SetValue("Projected Revenue");
oWorksheet.GetRange("A3").SetValue("Estimated Costs");
oWorksheet.GetRange("A4").SetValue("Cost price");
oWorksheet.GetRange("B2").SetValue(200);
oWorksheet.GetRange("B3").SetValue(250);
oWorksheet.GetRange("B4").SetValue(50);
oWorksheet.GetRange("C2").SetValue(200);
oWorksheet.GetRange("C3").SetValue(260);
oWorksheet.GetRange("C4").SetValue(120);
oWorksheet.GetRange("D2").SetValue(200);
oWorksheet.GetRange("D3").SetValue(200);
oWorksheet.GetRange("D4").SetValue(160);
var oRange = oWorksheet.GetRange("A2:D4");
oRange.Replace("200", "0", "xlWhole", "xlByColumns", "xlNext", true, true);
builder.SaveFile("xlsx", "Replace.xlsx");
builder.CloseFile();

Resulting document