Condividi tramite

Metodo DocumentBase.Protect

  • Articolo

Applica al documento uno tra diversi tipi di protezione.

Spazio dei nomi:  Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word.v4.0.Utilities (in Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Sintassi

'Dichiarazione
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
)

Parametri

  • noReset
    Tipo: System.Object%
    false per reimpostare i campi modulo sui relativi valori predefiniti.true per mantenere i valori correnti dei campi modulo se il documento è protetto.Se Type non è wdAllowOnlyFormFields, l'argomento NoReset verrà ignorato.
  • password
    Tipo: System.Object%
    Password richiesta per rimuovere la protezione dal documento.Vedere la sezione Osservazioni riportata di seguito.
  • useIRM
    Tipo: System.Object%
    Specifica se utilizzare il servizio Information Rights Management (IRM) per proteggere il documento da eventuali modifiche.
  • enforceStyleLock
    Tipo: System.Object%
    Specifica se a un documento protetto sono applicate restrizioni di formattazione.

Note

Quando un documento è protetto, è possibile apportare solo modifiche limitate, ad esempio aggiunta di annotazioni, revisioni o completamento di un form. Se il documento è già protetto quando si utilizza questo metodo, viene generata un'eccezione.

Evitare l'utilizzo di password hardcoded nelle applicazioni. Se per una procedura è richiesta una password, richiederla all'utente, archiviarla in una variabile e utilizzare tale variabile nel codice.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo Protect per consentire agli utenti di aggiungere solo commenti al documento. Per utilizzare questo esempio, eseguirlo dalla classe ThisDocument in un progetto a livello di 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);
}

Sicurezza di .NET Framework

Vedere anche

Riferimenti

DocumentBase Classe

Spazio dei nomi Microsoft.Office.Tools.Word