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

Referência

Definição

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Compartilhar via