DocumentBase.Protect 方法

向文档应用几种保护类型中的一种。

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

语法

声明
Public Sub Protect ( _
    type As WdProtectionType, _
    ByRef noReset As Object, _
    ByRef password As Object, _
    ByRef useIRM As Object, _
    ByRef enforceStyleLock As Object _
)
public void Protect(
    WdProtectionType type,
    ref Object noReset,
    ref Object password,
    ref Object useIRM,
    ref Object enforceStyleLock
)

参数

  • noReset
    类型:System.Object%
    如果为 false,则将窗体字段重置为默认值。如果为 true,则在文档处于保护状态时,保留当前窗体字段值。如果 Type 不是 wdAllowOnlyFormFields,则忽略 NoReset 参数。
  • password
    类型:System.Object%
    从文档中移除保护时所需的密码。(请参见下面的备注。)
  • useIRM
    类型:System.Object%
    指定在防止文档被更改时是否使用信息权限管理 (IRM)。
  • enforceStyleLock
    类型:System.Object%
    指定是否在受保护文档中强制格式设置限制。

备注

在文档受到保护时,用户只能进行有限的更改,如添加注释、进行修订或完成窗体。 如果在使用此方法时文档已经受到保护,则将引发异常。

应避免在应用程序中使用硬编码的密码。 如果在某个过程中需要使用密码,则向用户请求该密码并将它存储到一个变量中,然后在您的代码中使用该变量。

可选参数

有关可选参数的信息,请参见Office 解决方案中的可选参数

示例

下面的代码示例使用 Protect 方法来只允许用户向文档添加注释。 若要使用此示例,请从文档级项目内的 ThisDocument 类中运行此示例。

Private Sub DocumentProtect(ByRef securelyStoredPassword As Object)
    Me.Protect(Word.WdProtectionType.wdAllowOnlyComments, _
        Password:=securelyStoredPassword)
End Sub
private void DocumentProtect(ref object securelyStoredPassword)
{
    this.Protect(Word.WdProtectionType.wdAllowOnlyComments,
        ref missing, ref securelyStoredPassword, ref missing, 
        ref missing);
}

.NET Framework 安全性

请参见

参考

DocumentBase 类

Microsoft.Office.Tools.Word 命名空间