DocumentBase.Unprotect 方法
从文档中移除保护功能。
命名空间： Microsoft.Office.Tools.Word
程序集： Microsoft.Office.Tools.Word.v4.0.Utilities（在 Microsoft.Office.Tools.Word.v4.0.Utilities.dll 中）
语法
声明
Public Sub Unprotect ( _
ByRef password As Object _
)
public void Unprotect(
ref Object password
)
参数
- password
类型：System.Object%
要用来保护文档的密码。密码区分大小写。如果文档受密码保护而且用户没有提供正确的密码，则会显示一个对话框，提示用户输入正确的密码。
备注
应避免在应用程序中使用硬编码的密码。 如果在某个过程中需要使用密码，则向用户请求该密码并将它存储到一个变量中，然后在您的代码中使用该变量。
如果文档不受保护，则将引发异常。
可选参数
有关可选参数的信息，请参见Office 解决方案中的可选参数。
示例
下面的代码示例使用 Unprotect 方法从文档中移除保护功能。 该示例假定密码变量 securelyStoredPassword 是从用户输入获取的。 若要使用此示例，请从文档级项目内的 ThisDocument 类中运行此示例。
Private Sub DocumentUnprotect(ByRef securelyStoredPassword As Object)
If Me.ProtectionType <> Word.WdProtectionType.wdNoProtection Then
Me.Unprotect(securelyStoredPassword)
End If
End Sub
private void DocumentUnprotect(ref object securelyStoredPassword)
{
if (this.ProtectionType != Word.WdProtectionType.wdNoProtection)
{
this.Unprotect(ref securelyStoredPassword);
}
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。