How to set the Default Page in ASP.NET?

Question

Is there any section or code which allows us to set default page in web.config?

For example, when people first visit my website, I want them to see CreateThing.aspx rather than Default.aspx.

The solutions I already know:

Put this line of code => Response.Redirect("CreateThings.aspx") in Default.aspx Page_Load event but this method is really naive.
We can use IIS (default page configuration,) but I wanna do the same thing over on my ASP.NET application.

This could be another solution for now:

<defaultDocument>
    <files>
        <clear />
        <add value="Default.aspx" />
        <add value="Default.htm" />
        <add value="Default.asp" />
        <add value="index.htm" />
        <add value="index.html" />
        <add value="iisstart.htm" />
    </files>
</defaultDocument>

score 244 · Accepted Answer · edited Oct 08 '19 at 21:37

244

If using IIS 7 or IIS 7.5 you can use

<system.webServer>
    <defaultDocument>
        <files>
            <clear />
            <add value="CreateThing.aspx" />
        </files>
    </defaultDocument>
</system.webServer>

https://learn.microsoft.com/en-us/iis/configuration/system.webServer/defaultDocument/

edited Oct 08 '19 at 21:37

Chiramisu

4,687
7
47
77

answered Dec 16 '09 at 08:42

David Glenn

24,412
19
74
94

5

I found I needed to add the enabled="true" attribute to the defaultDocument tag i.e.: – John Ferguson May 14 '13 at 09:14
@JohnFerguson Cheers for that. – Nick Aug 14 '13 at 20:46
2

This is to be put in the tag of the Web.config file. – Mikaël Mayer Jun 16 '14 at 09:19
Will this work if the Default.aspx is in another folder? For Example: – Apollo Jun 30 '14 at 16:47
This didn't work for me, but user1469363's way did. If this isn't working for anyway give his solution a try (it is very simple/easy) – jnel899 Jul 06 '15 at 16:27
Would this work for a document not in the root directory? for example if I want my default index to be "mydomain.com/folder1/index.html" – James Wierzba Jan 04 '17 at 20:02

DavidTheDev · Answer 2 · 2018-11-09T14:27:04.173

23

Tip #84: Did you know… How to set a Start page for your Web Site in Visual Web Developer?

Simply right click on the page you want to be the start page and say "set as start page".

As noted in the comment below by Adam Tuliper - MSFT, this only works for debugging, not deployment.

edited Nov 09 '18 at 14:27

answered Nov 13 '13 at 15:13

DavidTheDev

405
4
16

1

Hmm. Works locally, but not after I deploy to azure. – V Maharajh Jun 24 '15 at 22:59
The accepted answer didn't work for me, but this did! Thanks! – jnel899 Jul 06 '15 at 16:26
6

@vivekmaharajh it wasn't the default because this is meant for testing/debugging - this technique doesn't configure your web server only your development environment. – Adam Tuliper Jan 04 '16 at 08:47
does not help redirect when users access the directory itself. – Malcolm Salvador Feb 02 '17 at 03:37

this. __curious_geek · Answer 3 · 2009-12-16T08:15:13.467

10

Map default.aspx as HttpHandler route and redirect to CreateThings.aspx from within the HttpHandler.

<add verb="GET" path="default.aspx" type="RedirectHandler"/>

Make sure Default.aspx does not exists physically at your application root. If it exists physically the HttpHandler will not be given any chance to execute. Physical file overrides HttpHandler mapping.

Moreover you can re-use this for pages other than default.aspx.

<add verb="GET" path="index.aspx" type="RedirectHandler"/>

//RedirectHandler.cs in your App_Code

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;

/// <summary>
/// Summary description for RedirectHandler
/// </summary>
public class RedirectHandler : IHttpHandler
{
    public RedirectHandler()
    {
        //
        // TODO: Add constructor logic here
        //
    }

    #region IHttpHandler Members

    public bool IsReusable
    {
        get { return true; }
    }

    public void ProcessRequest(HttpContext context)
    {
        context.Response.Redirect("CreateThings.aspx");
        context.Response.End();
    }

    #endregion
}

edited Dec 16 '09 at 08:15

answered Dec 16 '09 at 08:07

this. __curious_geek

42,787
22
113
137

So, you say when ever a request happens to `Default.aspx`, the handler will redirect the request to `CreateThing.aspx` . It looks a generic solution. Thank you. – Tarik Dec 16 '09 at 08:13
But would it cause HttpHandler pollution ? – Tarik Dec 16 '09 at 08:17
After your edit, I need to say : Well it could be. I think the simple thing would be like `Application.Run(new Form()1)` :) – Tarik Dec 16 '09 at 08:20
@Arron: You can always create a custom configuration section that will configure your `HttpHandler` for various different requests. You can also catch all *.aspx requests and see if request matches any of your configured URLs. Otherwise just pass it through. – Robert Koritnik Dec 16 '09 at 08:24

score 4 · Answer 4 · answered Dec 16 '09 at 08:09

4

If you are using forms authentication you could try the code below:

<authentication mode="Forms">
<forms name=".FORM" loginUrl="Login.aspx" defaultUrl="CreateThings.aspx" protection="All" timeout="30" path="/"> 
</forms>
</authentication>

answered Dec 16 '09 at 08:09

Zooking

3,491
4
34
39

To use Form Authentication, should I use the providers MemberShip or stuff ? I mean when I simply select Authentication Mode as Form rather than Windows, this code will work charmingly right ? – Tarik Dec 16 '09 at 08:14
I would say that this depends on the solution. If you need a more complex solution with different user profiles then you should go with MembershipProviders. But if it is a more simple setup you could just use and . – Zooking Dec 16 '09 at 10:11

score 4 · Answer 5 · answered Sep 22 '14 at 07:34

if you are using login page in your website go to web.config file

<authentication mode="Forms">
  <forms loginUrl="login.aspx" defaultUrl="index.aspx"  >
    </forms>
</authentication>

replace your authentication tag to above (where index.aspx will be your startup page)

and one more thing write this in your web.config file inside

<configuration>
   <system.webServer>
   <defaultDocument>
    <files>
     <clear />
     <add value="index.aspx" />
    </files>
  </defaultDocument>
  </system.webServer>

  <location path="index.aspx">
    <system.web>
      <authorization>
        <allow users="*" />
      </authorization>
   </system.web>
  </location>
</configuration>

Mahesh Malpani · Answer 6 · 2014-12-01T04:58:14.603

3

You can override the IIS default document setting using the web.config

<system.webServer>
    <defaultDocument>
      <files>
        <clear />
        <add value="DefaultPageToBeSet.aspx" />
      </files>
    </defaultDocument>
  </system.webServer>

Or using the IIS, refer the link for reference http://www.iis.net/configreference/system.webserver/defaultdocument

edited Dec 01 '14 at 04:58

answered Nov 11 '14 at 09:10

Mahesh Malpani

1,782
16
27

score 3 · Answer 7 · answered Mar 31 '17 at 13:13

I had done all the above solutions but it did not work.

My default page wasn't an aspx page, it was an html page.

This article solved the problem. https://weblog.west-wind.com/posts/2013/aug/15/iis-default-documents-vs-aspnet-mvc-routes

Basically, in my \App_Start\RouteConfig.cs file, I had to add a line:

public static void RegisterRoutes(RouteCollection routes)
{
    routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
    routes.IgnoreRoute("");   // This was the line I had to add here!

    routes.MapRoute(
        name: "Default",
        url: "{controller}/{action}/{id}",
        defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }
    );
}

Hope this helps someone, it took me a goodly while to find the answer.

I think the added code will work only for MVC apps. – Rahul Mahadik Oct 06 '21 at 10:39 — Rahul Mahadik, Oct 06 '21 at 10:39

score 1 · Answer 8 · answered Aug 04 '16 at 16:26

1

I prefer using the following method:

system.webServer>
  <defaultDocument>
    <files>
      <clear />
      <add value="CreateThing.aspx" />
    </files>
  </defaultDocument>
</system.webServer>

answered Aug 04 '16 at 16:26

encryptedwhisper

41
2

How to set the Default Page in ASP.NET?

8 Answers8

Linked

Related