Compartilhar via


DocumentBase.Protect(WdProtectionType, Object, Object, Object, Object) Método

Definição

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

public void Protect (Microsoft.Office.Interop.Word.WdProtectionType type, ref object noReset, ref object password, ref object useIRM, ref object enforceStyleLock);
member this.Protect : Microsoft.Office.Interop.Word.WdProtectionType * obj * obj * obj * obj -> unit
Public Sub Protect (type As WdProtectionType, Optional ByRef noReset As Object, Optional ByRef password As Object, Optional ByRef useIRM As Object, Optional ByRef enforceStyleLock As Object)

Parâmetros

type
WdProtectionType

O tipo de proteção para o documento especificado. WdProtectionType.

noReset
Object

false para redefinir os campos de formulário para seus valores padrão. true para reter os valores do campo de formulário atual, se o documento estiver protegido. Se Type não wdAllowOnlyFormFieldsfor , o NoReset argumento será ignorado.

password
Object

A senha necessária para remover a proteção do documento. (Consulte os comentários abaixo.)

useIRM
Object

Especifica se IRM (Gerenciamento de Direitos de Informação) deve ser usado ao proteger um documento contra alterações.

enforceStyleLock
Object

Especifica se as restrições de formatação são impostas em um documento protegido.

Exemplos

O exemplo de código a seguir usa o Protect método para permitir que os usuários adicionem apenas comentários ao documento. Para usar esse exemplo, execute-o na classe ThisDocument em um projeto no nível de documento.

private void DocumentProtect(ref object securelyStoredPassword)
{
    this.Protect(Word.WdProtectionType.wdAllowOnlyComments,
        ref missing, ref securelyStoredPassword, ref missing, 
        ref missing);
}
Private Sub DocumentProtect(ByRef securelyStoredPassword As Object)
    Me.Protect(Word.WdProtectionType.wdAllowOnlyComments, _
        Password:=securelyStoredPassword)
End Sub

Comentários

Quando um documento é protegido, os usuários podem fazer apenas alterações limitadas, como adicionar anotações, fazer revisões ou concluir um formulário. Se o documento já estiver protegido quando você usar esse método, uma exceção será gerada.

Evite usar senhas codificadas nos aplicativos. Caso uma senha seja necessária em um procedimento, solicite a senha junto ao usuário, armazene-a em uma variável e, em seguida, use a variável no código.

Parâmetros Opcionais

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

Aplica-se a