Intellisense, Web Extensions & Razor Views in ASP.NET MVC 3


Thursday 14 Jul 2011 at 21:00
Development  |  c# asp.net intellisense extensions razor

Tear Out Hair

Well, what a fun hour or two I’ve had today tearing out my hair trying to get a DLL of ASP.NET MVC 3 web extensions referenced in the project, with Razor view Intellisense working in a global manner.

The Web Extensions in question are the rather superb Telerik Extensions for ASP.NET MVC.

Basically, the process consists of:

  1. Copying the compiled Telerik.Web.Mvc.dll to your projects local bin folder (along with some other script and content files).
  2. Referencing the Telerik.Web.Mvc.dll component within your project references.
  3. Adding the relevant namespace to the web.config configuration file.
  4. Using your newly added extension!

Well, except it’s never quite that easy is it?  First mistake I made was to add the following section of web.config configuration settings:

<system.web.webPages.razor>
  <host factoryType="System.Web.Mvc.MvcWebRazorHostFactory, System.Web.Mvc,
            Version=3.0.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" />
  <pages pageBaseType="System.Web.Mvc.WebViewPage">
    <namespaces>
      <add namespace="System.Web.Mvc" />
      <add namespace="System.Web.Mvc.Ajax" />
      <add namespace="System.Web.Mvc.Html" />
      <add namespace="System.Web.Routing" />
      <add namespace="Telerik.Web.Mvc.UI"/>
    </namespaces>
  </pages>
</system.web.webPages.razor>

to the wrong web.config file!  Yes, this stuff above has to go in the web.config file that sits inside your “Views” folder.  Put this stuff in the main web.config that sits in your “root” folder and it won’t work.

So, having fixed that little problem, I proceeded to the joys of trying to actually use the HTML extension.

Configuration Image

Hey, what’s with the red squiggle, Visual Studio?

I’ve added the DLL to the bin folder, referenced said DLL in my project references, and even ensured I’ve added the namespace directive in the correct section of my correct web.config file.  So, why the errror?

Well, it turns out the magic to getting this to work, after you’ve added the web.config bits and referenced the DLL is two-fold:

1) Build your project.

This is required to ensure that Visual Studio is now “aware” of your newly added references, and can rebuild it own internal cache of namespaces, types and methods that will eventually be populated within the Intellisense picker.

2) Make sure you close the View’s code window in the IDE, then re-open it.

This step is the one that got me.  I hadn’t done this, and nowhere (except after a long hand slog of trawling through Google search results) does it mentions that this is needed.  Well, seems it’s a…err. ahem, feature, of Visual Studio that is required in order to get otherwise working Intellisense to actually work in the currently open file that you’re editing.

That’s it!  That was the problem.  I’d had the view’s code window open all the time within the Visual Studio IDE.  It wasn’t necessarily always the code window with the focus, but it was there within my list of windows tabs.  Closing and re-opening the code window caused the Intellisense to be re-initialised, and all was well.

My hair was saved!