Document.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 do documento e habilitar em cache salvar dados.

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

Sintaxe

Protected Overridable Sub UnprotectDocument

Me.UnprotectDocument()

protected virtual void UnprotectDocument()

Comentários

Substitua este método em um projeto document-nível para o palavra se seu documento está protegido 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 o documento temporariamente.

Por padrão, as alterações nos dados armazenados em cache em um documento protegido por senha não terão efeitas quando o documento é salvo.Para salvar as alterações nos dados armazenados em cache, você deve substituir os métodos a seguir no seu projeto:

UnprotectDocument.Quando o documento for salvo, a Visual Studio Tools for Office tempo de execução chama esse método. Adicione código para este método temporariamente desprotege o documento.Isso permite que as alterações feitas nos dados armazenados em cache a ser salvo.
ProtectDocument.Após o documento é salvo, 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 o documento.

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 o documento para que as alterações feitas nos dados armazenados em cache pode ser salvo. O exemplo salva primeiro o corrente ProtectionType valor, 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 ThisDocument classe em um projeto documento-nível para o palavra. O código pressupõe que a senha é armazenada em um campo denominado securelyStoredPassword.

<CachedAttribute()> _
Public CachedString AsString = "This string is cached in the document."Private protectionTypeValue As Word.WdProtectionType

ProtectedOverridesSub UnprotectDocument()
    IfMe.ProtectionType <> Word.WdProtectionType.wdNoProtection Then
        protectionTypeValue = Me.ProtectionType
        Me.Unprotect(securelyStoredPassword)
    EndIfEndSubProtectedOverridesSub ProtectDocument()
    Me.Protect(protectionTypeValue, Password:=securelyStoredPassword)
EndSub

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

private Word.WdProtectionType protectionTypeValue;

protectedoverridevoid UnprotectDocument()
{
    if (this.ProtectionType != Word.WdProtectionType.wdNoProtection)
    {
        protectionTypeValue = this.ProtectionType;
        this.Unprotect(ref securelyStoredPassword);
    }
}

protectedoverridevoid ProtectDocument()
{
    this.Protect(protectionTypeValue, ref missing,
        ref securelyStoredPassword, ref missing, ref missing);
}

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.