WPS 加载项开发 > 表格 API 参考 > Workbook > 方法 > Workbook.SetPasswordEncryptionOptions 方法
使用密码来设置对工作簿进行加密的选项。

语法

表达式.SetPasswordEncryptionOptions(PasswordEncryptionProvider, PasswordEncryptionAlgorithm, PasswordEncryptionKeyLength, PasswordEncryptionFileProperties)

表达式   一个代表 Workbook 对象的变量。

参数

名称 必选/可选 数据类型 说明
PasswordEncryptionProvider 可选 Variant 区分大小写的加密服务提供商的字符串。
PasswordEncryptionAlgorithm 可选 Variant 区分大小写的算法简称的字符串(例如“RC4”)。
PasswordEncryptionKeyLength 可选 Variant 加密密钥的长度,为 8 的倍数(40 或更大)。
PasswordEncryptionFileProperties 可选 Variant 如果为 True(默认值),则加密文件属性。

说明

PasswordEncryptionProviderPasswordEncryptionAlgorithmPasswordEncryptionKeyLength 参数不相互独立。选定的加密提供商限制了可以选择的算法和密钥长度的设置。

对于 PasswordEncryptionKeyLength 参数来说,没有固定的对密钥长度范围的限制。该范围是由“加密服务提供商”确定的,同时还确定加密算法。

示例

本示例设置活动工作簿的密码加密选项。

示例代码
function SetPasswordOptions() {
    ActiveWorkbook.SetPasswordEncryptionOptions(
        "Microsoft RSA SChannel Cryptographic Provider", "RC4", 6, true)
}

注释
该代码和此方法对于新的 ET 文件格式(xlsx、xlsb、xlsm 等...)不起任何作用,因为工作簿将始终使用 AES 128 位加密。如果某属性是使用此方法设置的,该属性将显示为已设置。当重新加载文件时,相应属性将重置为 AES 设置。


请参阅