DocumentBase.UnprotectDocument 方法

發行項
01/03/2014

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

命名空間： 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);
}