Document.ProtectDocument 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 aplicar proteção por senha para o documento novamente depois que os dados armazenados em cache foi salvo.

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

Sintaxe

Protected Overridable Sub ProtectDocument

Me.ProtectDocument()

protected virtual void ProtectDocument()

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 Protect método para proteger o documento.

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.

The Visual Studio Tools for Office tempo de execução chamadas a ProtectDocument mesmo se os dados armazenados em cache não foi possível salvar devido a algum erro não está relacionado à proteção por senha do método. Por exemplo, se você implementar o ICachedType interface para personalizar dados armazenados em cache como está armazenada no documento, o ProtectDocument método é chamado, mesmo que seu ICachedType implementação lança uma exceção que impede que os dados armazenados em cache sendo salvo.

Exemplos

O exemplo de código a seguir demonstra como substituir o ProtectDocument método reaplicar proteção foi removida, substituindo o UnprotectDocument 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.