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

その他の技術情報

キャッシュされたデータ

方法 : パスワードで保護されたドキュメント内のデータをキャッシュする