Workbook.UnprotectDocument メソッド (2007 System)

[アーティクル]
08/22/2008

更新 : 2008 年 7 月

Visual Studio Tools for Office ランタイムによって呼び出されます。これにより、ブックからパスワード保護を解除し、キャッシュされたデータを保存できるようになります。

名前空間 : Microsoft.Office.Tools.Excel
アセンブリ : Microsoft.Office.Tools.Excel.v9.0 (Microsoft.Office.Tools.Excel.v9.0.dll 内)

構文

'宣言
Protected Overridable Sub UnprotectDocument
'使用

Me.UnprotectDocument()

protected virtual void UnprotectDocument()

解説

パスワードで保護されたブック内のキャッシュされたデータが実行時に変更される可能性がある場合、Excel のドキュメントレベルのプロジェクトでこのメソッドをオーバーライドします。このメソッドの実装では、Unprotect メソッドを使用してブックの保護を一時的に解除します。

既定では、パスワードで保護されたブック内のキャッシュされたデータへの変更は、ブックが保存されるときには保持されません。キャッシュされたデータへの変更を保存するには、プロジェクトで次のメソッドをオーバーライドします。

UnprotectDocument. ブックを保存するとき、Visual Studio Tools for Office ランタイムはこのメソッドを呼び出します。このメソッドに、ブックの保護を一時的に解除するコードを追加します。これにより、キャッシュされたデータへの変更を保存できるようになります。
ProtectDocument. ブックを保存した後、Visual Studio Tools for Office ランタイムはこのメソッドを呼び出します。このメソッドに、ブックの保護を再適用するコードを追加します。

詳細については、「方法 : パスワードで保護されたドキュメント内のデータをキャッシュする」を参照してください。

例

次のコード例では、UnprotectDocument メソッドをオーバーライドしてブックの保護を一時的に解除し、キャッシュされたデータへの変更を保存できるようにする方法を示します。この例では、まず現在の ProtectStructure 値と ProtectWindows 値を保存し、後で ProtectDocument メソッドを使用して同じ種類の保護を再適用できるようにします。このコードを使用する場合は、Excel のドキュメントレベルのプロジェクトの ThisWorkbook クラスから実行してください。このコードでは、パスワードは securelyStoredPassword という名前のフィールドに格納されていることを前提としています。

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

Private protectStructureValue As Boolean
Private protectWindowsValue As Boolean

Protected Overrides Sub UnprotectDocument()
    protectStructureValue = Me.ProtectStructure
    protectWindowsValue = Me.ProtectWindows

    Me.Unprotect(securelyStoredPassword)
End Sub

Protected Overrides Sub ProtectDocument()
    Me.Protect(securelyStoredPassword, protectStructureValue, _
        protectWindowsValue)
End Sub

[CachedAttribute]
public string CachedString = "This string is cached in the workbook.";

private bool protectStructureValue;
private bool protectWindowsValue;

protected override void UnprotectDocument()
{
    protectStructureValue = this.ProtectStructure;
    protectWindowsValue = this.ProtectWindows;

    this.Unprotect(securelyStoredPassword);
}

protected override void ProtectDocument()
{
    this.Protect(securelyStoredPassword, protectStructureValue,
        protectWindowsValue);
}