Why am I getting the Yellow Screen Of Death on an Umbraco SurfaceController on a default/OOTB Umbraco installation?

Question

My Question Is This

What configuration step have I missed to make Mvc Surface Controllers work in Umbraco?

My theory is that since there is a folder in the default Umbraco install called /umbraco/ which is used to connect to the CMS that the physical path is interfiering with the route /umbraco/surface/{Controller}/{Action} thus resulting in the ASP.NET YSOD (and an IIS 404 when I try to access a controller on that route that isn't defined.)

---

Background Information

---

I have added this class to my App_Code folder in a freshly downloaded copy of Umbraco 6.1.6:

public class MembersController : SurfaceController
{
    public ActionResult Index()
    {
        return Content("Hello, Member!");
    }
}

When I navigate to what I think should be the route for my Index() method, I get a YSOD that says the resource could not be found:

the code is not executed and the above error is displayed; however, if I change the Uri to garbage I get an IIS 404 error:

I started getting this in an existing site, thinking my site was screwed up I tried it in a new copy of Umbraco 6.1.6 and got the exact same results.

For the record, I have also tried MembersSurfaceController and its associated Uri, which has the exact same result as above. YSOD when I hit the valid route, and IIS 404 when I don't.

I have changed my umbracoSettings.config to MVC in the /config/ directory as well.

---

update

---

I'm using the out-of-the-box web.config file, which has this:

 <system.webServer>
     <validation validateIntegratedModeConfiguration="false" />
     <modules runAllManagedModulesForAllRequests="true">
         <remove name="UrlRewriteModule" />
         <add name="UrlRewriteModule" type="UrlRewritingNet.Web.UrlRewriteModule, UrlRewritingNet.UrlRewriter" />
         .
         ..
         ...

On my default Umbraco site I don't have any rewrite rules defined; but on my actual site I have several rewrite rules in place. I'm thinking that's not causing it since I'm seeing the same behavior on both sites though...

I have tried removing UrlRewrite completely I get the same results.

---

Answer 1

The following approach works for me in Umbraco 7.1, and I expect it to work in 6.1 as well:

Create folder called 'Controllers' within your App_Code folder, and put your surface controllers in there (so that they will be within the 'Controllers' namespace).

E.g. I have the following controller in the App_Code\Controllers folder (and hence, within the 'Controllers' namespace):

namespace Controllers
{
    public class ServiceCentersController : SurfaceController
    {
        public ActionResult GetServiceCenters(string country = "", string region = "", string city = "")
        {
        ...
        }
    }
}

My site runs on localhost, so I can invoke the GetServiceCenters action by navigating to:

http://localhost/umbraco/Surface/ServiceCenters/GetServiceCenters?country=aa&region=bb&city=cc