WorkbookBase.ProtectDocument 方法

由 Visual Studio Tools for Office Runtime 调用,以便可以在保存了缓存数据后对工作簿重新应用密码保护。

命名空间:  Microsoft.Office.Tools.Excel
程序集:  Microsoft.Office.Tools.Excel.v4.0.Utilities(在 Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 中)

语法

protected virtual void ProtectDocument()

备注

如果工作簿受密码保护,且包含可能在运行时发生更改的缓存数据,则应在 Excel 的文档级项目中重写此方法。 实现此方法时,使用 Protect 方法对工作簿提供保护。

默认情况下,对于受密码保护的工作簿,保存工作簿时将不保持对其缓存数据所做的更改。 若要保存对缓存数据所做的更改,必须重写项目中的下列方法:

  • UnprotectDocument. 保存工作簿后,Visual Studio Tools for Office Runtime 将调用此方法。 请向可暂时取消工作簿保护的此方法中添加代码。 这使您可以保存对缓存数据所做的更改。

  • ProtectDocument. 保存工作簿后,Visual Studio Tools for Office Runtime 将调用此方法。 请向对工作簿重新应用保护的此方法中添加代码。

有关更多信息,请参见 如何:在受密码保护的文档中缓存数据

Visual Studio Tools for Office Runtime 会调用 ProtectDocument 方法,即使在因为某些与密码保护无关的错误而未能保存缓存的数据时也不例外。 例如,在通过实现 ICachedType 接口来自定义在文档中存储缓存数据的方式时,即使 ICachedType 实现引发了阻止保存缓存数据的异常,也会调用 ProtectDocument 方法。

示例

下面的代码示例演示如何重写 ProtectDocument 方法,以重新应用因重写 UnprotectDocument 方法而移除的保护。 若要使用此代码,请从 Excel 文档级项目的 ThisWorkbook 类中运行它。 该代码假定密码存储在一个名为 securelyStoredPassword 的字段中。

[CachedAttribute]
public string CachedString = "This string is cached in the workbook.";

private bool protectStructureValue;
private bool protectWindowsValue;

protected override void UnprotectDocument()
{
    protectStructureValue = this.ProtectStructure;
    protectWindowsValue = this.ProtectWindows;

    this.Unprotect(securelyStoredPassword);
}

protected override void ProtectDocument()
{
    this.Protect(securelyStoredPassword, protectStructureValue,
        protectWindowsValue);
}

.NET Framework 安全性

请参见

参考

WorkbookBase 类

Microsoft.Office.Tools.Excel 命名空间

UnprotectDocument

其他资源

缓存数据

如何:在受密码保护的文档中缓存数据