Click here to Skip to main content
Click here to Skip to main content

How to redirect the user to a "Down for Maintenance" page in ASP.NET

By , 16 Aug 2008
Rate this:
Please Sign up or sign in to vote.

Introduction

Usually, there arises a scenario when we upgrade our production site to a new release, we want the users to be redirected to the “Down for Maintenance” page. This article will help you understand the easiest technique to redirect all your website traffic to a standard "Down for Maintenance" HTML page.

How to redirect a user to a "Down for Maintenance" page?

The best way to implement this is using the app_offline.htm file. ASP.NET 2.0 has provided a fantastic functionality using which the users will automatically be redirected to the “Down for Maintenance” page. Just add an HTML file named “app_offline.htm” to the root directory of your website. Adding this file will clear the server cache. When ASP.NET sees the app_offline.htm file, it will shut-down the app-domain for the application (and not restart it for requests), and instead send back the contents of the app_offline.htm file in response to all new dynamic requests for the application.

Please take a note that the size of the file should be more that 512 bytes to be displayed. If the size of the file is less that 512 bytes, then IE browser settings need to be changed manually. The "Show Friendly HTTP Errors" check box from the Tools->Internet Options->Advanced tab within IE settings need to be unchecked. If this check-box is not unchecked and the app_offline.htm file size is less that 512 bytes, then the standard IE “Page cannot be displayed” message will be shown.

To start the website again, just remove this file from the root folder of your website. This will trigger the ASP.NET engine to cache all the page contents and display the pages. This has really made life simple Smile | :)

Points of interest

Sharing my experience: I have faced a similar situation in one of my projects, where we actually wrote an event handler in the Global.asax page to redirect the user to a standard HTML page, or used the redirect settings of IIS. But then, I came accros this awesome functionality provided by ASP.NET 2.0, and thought of sharing this golden concept with you all Smile | :)

Hope this helps! Your comments are always welcome!

History

  • Version 1.0 of article released on 16 August 08.
  • Version 1.1 of article released on 19 August 08. In this version, I modified the "512 KB" value to "512 bytes". This was a superb comment from one of the readers. Thanks to all readers!

License

This article, along with any associated source code and files, is licensed under The Common Development and Distribution License (CDDL)

About the Author

Sandeep Aparajit
Software Developer
United States United States
Sandeep has 7+ yrs of IT experience. He is Microsoft Certified Technology Specialist and has been certified for Analyzing Requirements and Defining Microsoft .NET Solution Architectures.
He is an active member of:
1. MSDN Forums
2. CodeProject.com
3. Community-Credit.com
4. Blogspot.com
 
You can find his contributions at:
My Blog
Photography

Comments and Discussions

 
QuestionImages in app_offline.htm PinmemberBretKnoll25-Jul-12 11:38 
AnswerRe: Images in app_offline.htm PinmemberBretKnoll26-Jul-12 4:10 
GeneralMy vote of 5 PinmemberMember 46022478-Oct-11 18:54 
GeneralEasy to use but has some flaws Pinmemberaphazel16-Nov-09 1:22 
GeneralNice Tips PinmemberAbhijit Jana20-Aug-08 4:11 
GeneralRe: Nice Tips PinmemberSandeep Aparajit20-Aug-08 12:22 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web02 | 2.8.140415.2 | Last Updated 17 Aug 2008
Article Copyright 2008 by Sandeep Aparajit
Everything else Copyright © CodeProject, 1999-2014
Terms of Use
Layout: fixed | fluid