共用方式為


DocumentBase.UnprotectDocument 方法

讓您有機會移除文件的密碼保護,並啟用儲存快取資料的功能。

命名空間:  Microsoft.Office.Tools.Word
組件:  Microsoft.Office.Tools.Word.v4.0.Utilities (在 Microsoft.Office.Tools.Word.v4.0.Utilities.dll 中)

語法

'宣告
Protected Overridable Sub UnprotectDocument
protected virtual void UnprotectDocument()

備註

如果文件是透過使用密碼所保護,且包含可能在執行階段變更的快取資料,則在 Word 文件層級專案中覆寫這個方法。 在這個方法的實作中,請使用 Unprotect 方法,暫時取消保護文件。

根據預設,當文件儲存時,不會保存受密碼保護之文件中的快取資料變更。 若要儲存快取資料的變更,您必須覆寫專案中的下列方法:

  • UnprotectDocument. 儲存文件時,Visual Studio Tools for Office Runtime 會呼叫這個方法。 為這個暫時取消保護文件的方法加入程式碼。 如此一來,就可以儲存快取資料的變更。

  • ProtectDocument. 儲存文件之後,Visual Studio Tools for Office Runtime 會呼叫這個方法。 為這個重新套用保護功能至文件的方法加入程式碼。

如需詳細資訊,請參閱如何:快取受密碼保護文件中的資料

範例

下列程式碼範例示範如何覆寫 UnprotectDocument 方法,暫時取消保護文件,以便可以儲存快取資料的變更。 這個程式碼會先儲存目前的 ProtectionType 值,這樣之後在 ProtectDocument 方法中就可以重新套用相同類型的保護。 這段程式碼假設密碼儲存在名為 securelyStoredPassword 的欄位中。 若要使用這個範例,請在文件層級專案中的 ThisDocument 類別執行。

<CachedAttribute()> _
Public CachedString As String = "This string is cached in the document."

Private protectionTypeValue As Word.WdProtectionType

Protected Overrides Sub UnprotectDocument()
    If Me.ProtectionType <> Word.WdProtectionType.wdNoProtection Then
        protectionTypeValue = Me.ProtectionType
        Me.Unprotect(securelyStoredPassword)
    End If
End Sub

Protected Overrides Sub ProtectDocument()
    Me.Protect(protectionTypeValue, password:=securelyStoredPassword)
End Sub
[CachedAttribute]
public string CachedString = "This string is cached in the document.";

private Word.WdProtectionType protectionTypeValue;

protected override void UnprotectDocument()
{
    if (this.ProtectionType != Word.WdProtectionType.wdNoProtection)
    {
        protectionTypeValue = this.ProtectionType;
        this.Unprotect(ref securelyStoredPassword);
    }
}

protected override void ProtectDocument()
{
    this.Protect(protectionTypeValue, ref missing,
        ref securelyStoredPassword, ref missing, ref missing);
}

.NET Framework 安全性

請參閱

參考

DocumentBase 類別

Microsoft.Office.Tools.Word 命名空間

ProtectDocument

其他資源

快取資料

如何:快取受密碼保護文件中的資料