Document.Protect 方法 (2007 system)

  • 项目

更新：2007 年 11 月

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

命名空间：  Microsoft.Office.Tools.Word
程序集：  Microsoft.Office.Tools.Word.v9.0（在 Microsoft.Office.Tools.Word.v9.0.dll 中）

语法

声明
Public Sub Protect ( _
    Type As WdProtectionType, _
    ByRef NoReset As Object, _
    ByRef Password As Object, _
    ByRef UseIRM As Object, _
    ByRef EnforceStyleLock As Object _
)
用法
Dim instance As Document
Dim Type As WdProtectionType
Dim NoReset As Object
Dim Password As Object
Dim UseIRM As Object
Dim EnforceStyleLock As Object

instance.Protect(Type, NoReset, Password, _
    UseIRM, EnforceStyleLock)

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 方法来只允许用户向文档添加注释。

此示例针对的是文档级自定义项。

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);
}

权限

另请参见

参考

Document 类

Document 成员

Microsoft.Office.Tools.Word 命名空间