Licensing: MIT License
The genesis of **Quartz for ASP.NET** was what I felt were some [Problems with ASP.NET MVC Framework Design](/writing/problems-with-asp-net-mvc-framework-design/). Quartz for ASP.NET can be used in conjunction with ASP.NET MVC or in regular ASP.NET WebApplication/Website projects (without any WebForms). It works the same either way. ### Videos and Downloads There are a few Videos in the [Videos section](#videos) below, that you may want to watch. In the [Downloads](#downloads) you can find the following: 1. The Complete source code (.Net 4.0 compatible only at the moment) 2. A Sample Project 3. A New Quartz Project Item - for VS 2010 4. A New Quarts Builder Item - for VS 2010 5. A New Quartz View Item - for VS 2010 Quartz for ASP.NET is the most intuitive way to build dynamic web pages, using a powerful combination of class Composition and Inheritance. Today’s dynamic pages are rarely simple, so you need something that gives you more control over how your pages are composed. With Quartz for ASP.NET you continue to get the **loose coupling** and **separation of concerns** that the MVC design pattern provides and in addition you also get - Loose coupling between Views and Template - Templates are Html. That is there is no html+code OR code+html - Views can be treated as real classes - inheritance/polymorphism and you write code in a.cs file - Strong typing and F12 navigation - Plug-able Websites/applications However, the primary driver for Quartz for ASP.NET was the way in which you build pages in ASP.NET MVC and the problems with that design. Figure 1 below, shows the relationship and flow of control in the ASP.NET MVC design, between a Controller and a View, Partial View and Master Page/Layout Page.
Builder and the Views and Master Page Template.
Builder orchestrates the entire composition. The way it works is this:
1. The Builder picks a Master Template (an Html file). This template usually has spots that need to be filled in, as shown in [Figure 2 above](#figure2), the "Page"
2. It then picks the appropriate views for each of these spots (a base class (of the Builder) could enlist some views to do the "common" parts and the descendant Builder could choose to override these choices)
3. Since the Builder has access to instances of each of the views enlisted to render the page, it can talk directly to these views to hand them the data each of them will need to do their part.
4. Again, since the Builder has access to views as objects instances it can treat views polymorphic-ally if required or use inheritance or both
5. Once it has done the above, each of the views go off and do their part (generate html) and a page is produced.
6. Since views are regular .NET classes you have the full might of the .NET framework at your disposal. And since their only job is to produce html in conjunction with the Request Context (of the current request) and the data they’ve been handed by the Builder, it’s totally up to you, how you do that. The Quartz framework does provide some options out of the box, and they are:
- Simply generate html using just code and data, writing directly to the output
- Use html templates (with placeholder tags – parser included with the framework) to render html directly to the output. This method has the added advantage that you have no html in code and templates can be re-used across multiple views and/or a view can use multiple templates or decide to use a different template conditionally
- Use any other mechanism to generate html, such as T4 Templates.
The code listing below is a sample of the code you'd write in a Builder's BuildPage() method.
### Sample Code
```csharp
protected override void BuildPage(HttpContextBase httpContext, object model)
{
var featuresAllPageViewModel = (FeaturesAllPageViewModel)model;
TitleView.Title = "Quartz for ASP.NET - Features";
AdBoxTopView.BoxTitle = "Highlights";
AdBoxTopView.Model = featuresAllPageViewModel.AdBoxModel;
RegisterView("Body", new FeaturesAllView(httpContext, this, featuresAllPageViewModel.Features));
}
}
```
## Composing Pages with Quartz for ASP.NET
Traditionally, web application frameworks work in a inside-out fashion. That is, when you field a request for a page, you’re really starting with the inner most part of the page and working your way out (by calling RenderAction or RenderPartial in MVC parlance). In Quartz for ASP.NET you start with a template and compose your page using multiple views. It’s really a lot more intuitive to think and work this way, than inside-out.
Repeater in this demo as well so you'll also get to see how the Repeater can be used along with templates.
## Downloads
The downloadable .zip files contains the following files
1. The Complete source code (.Net 4.0 compatible only at the moment)
2. A Sample Project
3. A New Quartz Project Item - for VS 2010
4. A New Quartz Builder Item - for VS 2010
5. A New Quartz View Item - for VS 2010
[Quartz For ASP.NET Source](https://web.archive.org/web/20240809182901/http://www.matlus.com/content/uploads/Quartz/Matlus.Quartz.zip)
## Installing Project and Item Templates in VS.NET
If you've not installed project and item templates in Visual Studio before, please follow these steps:
Extract the files from the downloaded zip file to a temporary folder.
First we'll installed the **Project Item Template**.
1. Locate the file called – Quartz Web Application.zip
2. Navigate to the Visual Studio Project Templates (C#) folder. On my machine this folder is located at:
3.
```text
C:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE\ProjectTemplates\CSharp\
```
4. Create a folder called Quartz under the CSharp folder as shown in [Figure 4](#figure4) below
5. Copy the Quartz Web Application.zip into this folder
6. Follow the steps listed in the [Rebuilding the Visual Studio Cache](#rebuildingvscache) section below in order to rebuild the VS.NET cache.
7. Start Visual Studio (rebuild the cache first!) and create a new project.
8. You'll notice a Quartz folder in Installed Templates ree view on the left (as seen in [Figure 5](#figure5) below) and when you select it, you'll see the Quartz Web Application project item template and shown in Figure 5 below
ItemTemplates\CSharp folder, which on my machine is:
2.
```text
C:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE\ItemTemplates\CSharp
```
3. Like before, create a folder called Quartz under this folder as shown in [Figure 6](#figure6) below.
4. Copy the QuartzBuilder.zip and QuartzView.zip files into this new folder
5. Rebuild the Visual Studio cache again using the steps listed in the [Rebuilding the Visual Studio Cache](#rebuildingvscache) section below.
6. After you've done that, you'll see item templates for a Quartz Builder and Quartz View when you add an item to your Quartz Web Application project, as shown in [Figure 7](#figure7) below
Visual Studio Command Prompt (i.e. Start | All Programs | Microsoft Visual Studio 2010 | Visual Studio Tools | Visual Studio Command Prompt)
3. Execute the following command: devenv /installvstemplates