DocumentBase.UnprotectDocument – metoda
Poskytuje možnost odebrat ochranu heslem z dokumentu a umožnit 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 UnprotectDocument
protected virtual void UnprotectDocument()
Poznámky
Přepište tuto metodu v úrovni dokumentu projekt pro aplikaci Word, pokud váš 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 této metody slouží Unprotect metoda dočasně Odemknout dokument.
Ve výchozím nastavení nejsou změny dat uložených v mezipaměti v dokumentu chráněného heslem trvalé při uložení dokumentu.Pokud chcete uložit změny dat v mezipaměti, je nutné v projektu přepsat následující metody:
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 uložení změn dat v mezipaměti.
ProtectDocument.Po uložení dokumentu Visual Studio Tools for Office runtime volá tuto metodu.Přidejte kód do této metody, které znovu ochranu dokumentu.
Další informace naleznete v tématu Postupy: Ukládání dat do mezipaměti v dokumentu chráněném heslem.
Příklady
Následující příklad kódu ukazuje, jak přepsat UnprotectDocument metoda dočasně Odemknout dokument, takže můžete uložit změny data uložená v mezipaměti.V příkladu nejprve uloží aktuální ProtectionType hodnotu, takže stejný typ ochrany lze znovu později v ProtectDocument metody.Kód předpokládá, že heslo je uloženo v poli s názvem securelyStoredPassword.Chcete-li tento příklad použít, spusťte jej ze třídy ThisDocument 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.
Viz také
Referenční dokumentace
Microsoft.Office.Tools.Word – obor názvů
Další zdroje
Postupy: Ukládání dat do mezipaměti v dokumentu chráněném heslem