DocumentBase.UnprotectDocument – metoda

Článek
05/14/2013

Poskytuje příležitost z dokumentu odebrat ochranu heslem a umožnit uložení dat v 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 UnprotectDocument

protected virtual void UnprotectDocument()

Poznámky

Přepište tuto metodu v projektu na úrovni dokumentu aplikace Word v případě, že dokument je chráněn heslem a obsahuje data uložená v mezipaměti, který může změnit za běhu.Ve vaší implementaci tuto metodu použít Unprotect metoda dočasně odstranit ochranu dokumentu.

Ve výchozím nastavení nejsou trvalé změny data uložená v mezipaměti v dokument chráněný heslem, při uložení dokumentu.Chcete-li změny uložit data uložená v mezipaměti, musíte přepsat následujících metod v projektu:

UnprotectDocument.Při uložení dokumentu Visual Studio Tools for Office runtime volá tuto metodu.Přidejte kód do této metody, které dočasně unprotects dokumentu.To umožňuje data uložená v mezipaměti, chcete-li uložit změny.
ProtectDocument.Po uložení dokumentu Visual Studio Tools for Office runtime volá tuto metodu.Přidejte kód do této metody, které znovu použije ochrana dokumentu.

Další informace naleznete v tématu Jak: Data v mezipaměti v dokumentu chráněného heslem.

Příklady

Následující příklad kódu ukazuje, jak přepsat UnprotectDocument metoda dočasně Odemknout dokument tak, aby bylo možné uložit změny data uložená v mezipaměti.Příklad nejprve uloží aktuální ProtectionType hodnotu tak, aby ji znovu stejného typu ochrany lze použít později v ProtectDocument metoda.Kód předpokládá, že heslo je uloženo v poli s názvem securelyStoredPassword.Chcete-li použít tento příklad, spusťte jej z ThisDocument třídy v projektu na ú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.