WorkbookBase.ProtectDocument – metoda

Článek
08/11/2011

Volat Visual Studio Tools for Office runtime , takže můžete znovu použítochrana heslodo sešitu po uložení dat z mezipaměti.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel.v4.0.Utilities (v Microsoft.Office.Tools.Excel.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 Excel sešit je chráněn hesloa obsahuje data v mezipaměti, který může změnit za běhu. Vaše provádění tuto metodapoužijte Protect metoda ochrany sešitu.

Standardně se změní data v mezipaměti v heslo-zamknutého sešitu nepřetrvají po uložení sešitu. Chcete-li změny uložit do mezipaměti, je nutné přepsat následující metody v projekt:

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

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

Visual Studio Tools for Office runtime Volání ProtectDocumentmetoda , i když data v mezipaměti nelze uložit z důvodu chyba nesouvisejícíochrana heslo. Například implementací ICachedType rozhraní upravit data jak v mezipaměti uložena v dokumentu ProtectDocument je volána metoda i vaše ICachedType Implementace výjimku, která zabraňuje ukládání dat v 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. Chcete-li použít tento kód spustit z ThisWorkbook třída v projekt úrovni dokumentu aplikace Excel. Kód předpokládá, že heslo je uloženo v pole s názvem 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);
}

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.