Some very specialized physiological requirements are required for a fish to be able to survive in both saltwater and freshwater (or brackish conditions). Very few species possess these specializations, and no typical coral reef fish do.
To put into perspective why switching a reef fish to freshwater won't work and will simply kill the fish, let me use an analogy. Some archaea live and thrive at a temperature of 90 C, or 194 F. Can you survive at 194 F? What if we raise the temperature of your living space only 1 F per day? It doesn't matter how fast or how slow we go, human physiology has certain limitations, and above around 105 F an adult person will die due to swelling of the brain within the skull. The absolute limit for any sort of vertebrate, and almost all organisms, is around 120 F, when most proteins begin to denature. Living at extraordinarily high temperatures requires very specific and substantial adaptations of physiology. Some archaea have done this, but other organisms have not. Likewise, coral reef fish, and most marine species, lack the required adaptations to deal with freshwater. If you expose them to freshwater, regardless of the amount of time you give them to acclimatize, they will ultimately die. It's not magic, it's physiology.
cj