Workbook.UnprotectDocument O método (sistema de 2007)

Artigo
08/25/2010

Chamado pelo Visual Studio Tools for Office tempo de execução para que você pode remover a proteção por senha da pasta de trabalho e ativar em cache salvar dados.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v9.0 (em Microsoft.Office.Tools.Excel.v9.0.dll)

Sintaxe

Protected Overridable Sub UnprotectDocument

Me.UnprotectDocument()

protected virtual void UnprotectDocument()

Comentários

Substitua este método em um projeto documento-nível para o Excel se sua pasta de trabalho está protegida por meio de uma senha e contém dados em cache que podem ser alterados em time de execução.Na sua implementação desse método, use o Unprotect método para desproteger a pasta de trabalho temporariamente.

Por padrão, as alterações nos dados armazenados em cache em uma pasta de trabalho protegida por senha não terão efeitas quando a pasta de trabalho é salva.Para salvar as alterações nos dados armazenados em cache, você deve substituir os métodos a seguir no seu projeto:

UnprotectDocument.Quando a pasta de trabalho for salva, a Visual Studio Tools for Office tempo de execução chama esse método. Adicione código para este método temporariamente desprotege a pasta de trabalho.Isso permite que as alterações feitas nos dados armazenados em cache a ser salvo.
ProtectDocument.Após a pasta de trabalho é salva, a Visual Studio Tools for Office tempo de execução chama esse método. Adicione código para este método reaplica proteção para a pasta de trabalho.

Para obter mais informações, consulte Como: Dados de cache em um documento protegida por senha.

Exemplos

O exemplo de código a seguir demonstra como substituir o UnprotectDocument método para temporariamente Desproteger pasta de trabalho para que as alterações feitas nos dados armazenados em cache pode ser salvo. O exemplo salva primeiro o corrente ProtectStructure e ProtectWindows valores, para que o mesmo tipo de proteção pode ser reaplicado posteriormente na ProtectDocument método. Para usar esse código, executá-lo a partir de ThisWorkbook classe em um projeto documento-nível para Excel. O código pressupõe que a senha é armazenada em um campo denominado securelyStoredPassword.

<CachedAttribute()> _
Public CachedString AsString = "This string is cached in the workbook."Private protectStructureValue AsBooleanPrivate protectWindowsValue AsBooleanProtectedOverridesSub UnprotectDocument()
    protectStructureValue = Me.ProtectStructure
    protectWindowsValue = Me.ProtectWindows

    Me.Unprotect(securelyStoredPassword)
EndSubProtectedOverridesSub ProtectDocument()
    Me.Protect(securelyStoredPassword, protectStructureValue, _
        protectWindowsValue)
EndSub

[CachedAttribute]
publicstring CachedString = "This string is cached in the workbook.";

privatebool protectStructureValue;
privatebool protectWindowsValue;

protectedoverridevoid UnprotectDocument()
{
    protectStructureValue = this.ProtectStructure;
    protectWindowsValue = this.ProtectWindows;

    this.Unprotect(securelyStoredPassword);
}

protectedoverridevoid ProtectDocument()
{
    this.Protect(securelyStoredPassword, protectStructureValue,
        protectWindowsValue);
}

Permissões

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de códigos parcialmente Confiável.