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

语法

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

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

参数

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

说明

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

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

示例

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

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

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


请参阅