Método DocumentBase.Protect

Artigo
08/01/2011

Aplica-se um dos vários tipos de proteção ao documento.

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

Sintaxe

'Declaração
Public Sub Protect ( _
    type As WdProtectionType, _
    ByRef noReset As Object, _
    ByRef password As Object, _
    ByRef useIRM As Object, _
    ByRef enforceStyleLock As Object _
)

public void Protect(
    WdProtectionType type,
    ref Object noReset,
    ref Object password,
    ref Object useIRM,
    ref Object enforceStyleLock
)

Parâmetros

type
Tipo: Microsoft.Office.Interop.Word.WdProtectionType
O tipo de proteção para o documento especificado.WdProtectionType.

noReset
Tipo: System.Object%
false Para redefinir os campos de formulário para seus valores padrão.truepara manter os valores de campo de formulário atual, se o documento está protegido.Se Type não é wdAllowOnlyFormFields, o NoReset argumento é ignorado.

password
Tipo: System.Object%
A senha necessária para remover a proteção do documento.(Consulte comentários abaixo).

useIRM
Tipo: System.Object%
Especifica se deve usar o gerenciamento de direitos de informação (IRM) ao proteger um documento contra alterações.

enforceStyleLock
Tipo: System.Object%
Especifica se as restrições de formatação são impostas em um documento protegido.

Comentários

Quando um documento está protegido, os usuários podem fazer apenas alterações limitadas, como, por exemplo, adicionar anotações, fazer revisões ou preencher um formulário. Se o documento já estiver protegido quando você usa esse método, uma exceção é lançada.

Evite usar senhas embutidas em seus aplicativos. Se for necessária uma senha em um procedimento, solicite a senha do usuário, armazená-lo em uma variável e, em seguida, use a variável no seu código.

Optional Parameters

Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O seguinte exemplo de código usa a Protect método para permitir que os usuários adicionem somente os comentários no documento. Para usar esse exemplo, executá-lo do ThisDocument a classe em um projeto de nível de documento.

Private Sub DocumentProtect(ByRef securelyStoredPassword As Object)
    Me.Protect(Word.WdProtectionType.wdAllowOnlyComments, _
        Password:=securelyStoredPassword)
End Sub

private void DocumentProtect(ref object securelyStoredPassword)
{
    this.Protect(Word.WdProtectionType.wdAllowOnlyComments,
        ref missing, ref securelyStoredPassword, ref missing, 
        ref missing);
}

Segurança do .NET Framework

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ódigo parcialmente confiáveis.

Consulte também

Referência

DocumentBase Classe

Namespace Microsoft.Office.Tools.Word

Compartilhar via