跳到主要内容

AddProtectedRange

从当前工作表的选定数据区域创建指定类型的受保护区域。

语法

expression.AddProtectedRange(sTitle, sDataRange);

expression - 表示 ApiWorksheet 类的变量。

参数

名称必需/可选数据类型默认值描述
sTitle必需string将为当前受保护区域显示的标题。
sDataRange必需string将用于获取受保护区域数据的选定单元格区域。

返回值

ApiProtectedRange | null

示例

锁定单元格范围使其在电子表格中未经许可无法编辑。

// How do I protect a specific group of cells from changes in a spreadsheet?

// Restrict editing on a named cell range by marking it as protected.

let worksheet = Api.GetActiveSheet();
worksheet.GetRange("A1").SetValue("1");
worksheet.GetRange("B1").SetValue("2");
worksheet.AddProtectedRange("protectedRange", "Sheet1!$A$1:$B$1");