Cracking informational post from Scott Guthrie – and I can’t believe I’d never heard of this before!!
Original post from Scott: http://weblogs.asp.net/scottgu/archive/2005/10/06/426755.aspx:
Basically, if you place a file with this name in the root of a web application directory, ASP.NET 2.0 will shut-down the application, unload the application domain from the server, and stop processing any new incoming requests for that application. ASP.NET will also then respond to all requests for dynamic pages in the application by sending back the content of the app_offline.htm file (for example: you might want to have a “site under construction” or “down for maintenance” message).
This provides a convenient way to take down your application while you are making big changes or copying in lots of new page functionality (and you want to avoid the annoying problem of people hitting and activating your site in the middle of a content update). It can also be a useful way to immediately unlock and unload a SQL Express or Access database whose .mdf or .mdb data files are residing in the /app_data directory.
Once you remove the app_offline.htm file, the next request into the application will cause ASP.NET to load the application and app-domain again, and life will continue along as normal.
And also worthy of note is that the returned content must be greater than 512kb, to get over an annoying anomoly within IE6. Simply flesh out the content of the file to greater than 512kb (use comments for example).
Leave a Reply