Why Do I Get Unexpected 404 Errors in Visual Web Developer 2005 Express Edition?

Today I was experiencing unexpected 404 "The resource cannot be found" errors when working with Visual Web Developer 2005 Express Edition beta 2 in combination with the ASP.NET Development Server. No matter what I tried, and what file I tried to open, I kept getting the same error.

I was just about to get very angry, after trying to change about every property on my project, web server and firewall when I noticed an additional file in the root of my site called app_offline.htm. It turned out this file was the culprit. I have no idea how the file got there, but I think it has been put there by Visual Web Developer somehow

There is hardly any documentation about this file. In fact, the only reference Google found was in the ASP.NET 2 Quickstart Tutorials. From a bit of experimenting, I found out that when this file is located in the root of your site and is completely empty, all files in your site (including images and other resources) return a 404 error. This can be useful if you temporarily need to block access to all of your pages.

To customize the error message your users get, you can simply add some markup to this app_offline.htm. Whenever this file contains any content, that content will be shown instead of the nasty 404 error message.

Note that this is different from the option "Take application offline" that you find in the ASP.NET Web Site Administration Tool. Whenever you use that option to take your application offline, the following key is added to the <system.web> node in your web.config file:

<httpRuntime enable="false" />

For more information about the app_offline.htm file, check out this blog post by Scott Guthrie.

Where to Next?

Wonder where to go next? You can post a comment on this article.

Doc ID 369
Full URL https://imar.spaanjaars.com/369/why-do-i-get-unexpected-404-errors-in-visual-web-developer-2005-express-edition
Short cut https://imar.spaanjaars.com/369/
Written by Imar Spaanjaars
Date Posted 05/14/2005 17:31
Date Last Reviewed 05/23/2006 20:12
Listened to when writing Headstrong by Earshot (Track 1 from the album: Letting Go)


Talk Back! Comment on Imar.Spaanjaars.Com

I am interested in what you have to say about this article. Feel free to post any comments, remarks or questions you may have about this article. The Talk Back feature is not meant for technical questions that are not directly related to this article. So, a post like "Hey, can you tell me how I can upload files to a MySQL database in PHP?" is likely to be removed. Also spam and unrealistic job offers will be deleted immediately.

When you post a comment, you have to provide your name and the comment. Your e-mail address is optional and you only need to provide it if you want me to contact you. It will not be displayed along with your comment. I got sick and tired of the comment spam I was receiving, so I have protected this page with a simple calculation exercise. This means that if you want to leave a comment, you'll need to complete the calculation before you hit the Post Comment button.

If you want to object to a comment made by another visitor, be sure to contact me and I'll look into it ASAP. Don't forget to mention the page link, or the Doc ID of the document.

(Plain text only; no HTML or code that looks like HTML or XML. In other words, don't use < and >. Also no links allowed.