DocumentBase.ProtectDocument – metoda

Článek
08/11/2011

Poskytuje příležitost znovuochrana heslodokumentu po uložení dat z mezipaměti.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word.v4.0.Utilities (v Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Syntaxe

'Deklarace
Protected Overridable Sub ProtectDocument

protected virtual void ProtectDocument()

Poznámky

Tato metoda v úrovni dokumentu projekt přepište Word dokument je chráněn hesloa obsahuje data v mezipaměti, který může změnit za běhu. Použít tento způsob implementace, Protect Metoda ochrany dokumentu.

Standardně se změní data v mezipaměti v heslo-chráněného dokumentu jsou trvalé, pokud je dokument uložen. Chcete-li změny uložit do mezipaměti, je nutné přepsat následující metody v projekt:

UnprotectDocument. Při uložení dokumentu Visual Studio Tools for Office runtime Tato metodavolá. Přidat kód, který tuto metoda , která dočasně unprotects dokumentu. To umožňuje změny uložit data v mezipaměti.
ProtectDocument. Po uložení dokumentu Visual Studio Tools for Office runtime Tato metodavolá. Přidat kód, který tuto metoda , která znovu ochrana dokumentu.

Další informace naleznete v tématu How to: Cache Data in a Password-Protected Document.

Visual Studio Tools for Office runtime Volání ProtectDocument Metoda, i když data v mezipaměti nelze uložit z důvodu některé chyby, které nesouvisí s ochranu heslem. Například implementací ICachedTyperozhraní upravit data jak v mezipaměti uložena v dokumentu ProtectDocumentje volánametoda i vaše ICachedType Implementace vygeneruje výjimka , který zabraňuje uložení dat z mezipaměti.

Příklady

Následující příklad kódu ukazuje, jak přepsat ProtectDocument Metoda ochrany, který byl odebrán přepsáním znovu UnprotectDocument metody. Kód předpokládá, že heslo je uloženo v pole s názvem securelyStoredPassword. Chcete-li použít tento příklad spustit z ThisDocument třídy v projektu úrovni dokumentu.

<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);
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.