Click here to Skip to main content
12,506,204 members (45,697 online)
Click here to Skip to main content
Add your own
alternative version

Stats

227.1K views
12.6K downloads
309 bookmarked
Posted

AJAX Event Calendar (Scheduler) for ASP.NET MVC in 80 Lines of Code

, 28 Jun 2016 Apache
Rate this:
Please Sign up or sign in to vote.
How to build an AJAX Event Calendar (Scheduler) using the open-source DayPilot Lite for ASP.NET MVC library (Apache Software License 2.0).

AJAX Event Calendar for ASP.NET MVC

Introduction

This sample project shows how to build an AJAX Event Calendar (Scheduler) using the open-source DayPilot Lite for ASP.NET MVC library (Apache Software License 2.0). We will build our sample with ASP.NET MVC 5, Visual Studio 2012, and LocalDB SQL Server.

Online demos:

The monthly event calendar view is supported since DayPilot Lite for MVC 1.3 release.

We will need only 80 lines for code for the full drag&drop functionality (event creating, moving and resizing).

Three steps are necessary:

  • Library: Include DayPilot.Web.Mvc.dll and scripts in your project and add a reference to it.
  • View: Create a new MVC Razor view and add DayPilot Calendar widget using Html.DayPilotCalendar extension.
  • Controller: Create an MVC controller that will supply the data.

CSS Themes (New in 1.4)

Since v1.4, DayPilot Lite shares the JavaScript core with DayPilot Lite for JavaScript [javascript.daypilot.org]. See also HTML5 Event Calendar (Open-Source) [code.daypilot.org].

DayPilot Lite for ASP.NET MVC 1.4 [mvc.daypilot.org] introduces full CSS styling support, including CSS themes. You can also build your own theme in the online CSS theme designer [themes.daypilot.org].

Google-Like CSS Theme

AJAX Event Calendar for ASP.NET MVC - Google-Like CSS Theme

Transparent CSS Theme

AJAX Event Calendar for ASP.NET MVC - Transparent CSS Theme

Green CSS Theme

AJAX Event Calendar for ASP.NET MVC - Green CSS Theme

White CSS Theme

AJAX Event Calendar for ASP.NET MVC - White CSS Theme

Traditional CSS Theme

AJAX Event Calendar for ASP.NET MVC - Traditional CSS Theme

1. DayPilot.Web.Mvc Library

Download DayPilot Lite for ASP.NET MVC open-source package.

Copy DayPilot JavaScript files from the Scripts folder of the package to your project (Scripts/DayPilot):

  • daypilot-all.min.js

Copy DayPilot.Web.Mvc.dll from the Binary folder of the package to your project (Bin).

Add a reference to DayPilot.Web.Mvc.dll:

Add reference to DayPilot.Web.Mvc.dll

2. MVC View (8 Lines of Code)

Create a new ASP.NET MVC view (Views/Home/Index.cshtml):

@{ ViewBag.Title = "ASP.NET MVC Razor Event Calendar"; }
<h2>ASP.NET MVC Razor Event Calendar</h2> 

Add DayPilot JavaScript libraries:

<script src="@Url.Content("~/Scripts/DayPilot/daypilot-all.min.js")" type="text/javascript"></script> 

Add the event calendar initialization code:

@Html.DayPilotCalendar("dpc", new DayPilotCalendarConfig
{
  BackendUrl = Url.Content("~/Home/Backend"),
}) 

Note that the minimum required code is quite short. It only has to point to the backend MVC controller ("~/Home/Backend") that will supply the calendar event data using an AJAX call.

Don't forget to add DayPilot.Web.Mvc namespace to /Views/Web.config so it recognizes the Html.DayPilotCalendar helper:

<configuration>
  <system.web.webPages.razor>
    <pages pageBaseType="System.Web.Mvc.WebViewPage">
      <namespaces>
        ...
        <add namespace="DayPilot.Web.Mvc"/>
      </namespaces>
    </pages>
  </system.web.webPages.razor>
</configuration>

This is the complete code of our new MVC view with the event calendar:

@{ ViewBag.Title = "ASP.NET MVC Razor Event Calendar"; }

<h2>ASP.NET MVC Razor Event Calendar</h2>

3. MVC Controller (34 Lines of Code)

Create a new MVC controller (Controllers/HomeController.cs):

public class HomeController : Controller
{
  public ActionResult Index()
  {
    return View();
  }
}

Add a new action handler for the calendar backend. It will be accessible as /Home/Backend.

public ActionResult Backend()
{
  return new Dpc().CallBack(this);
}

This action will pass control to a new instance of a custom Dpc class that derives from DayPilotCalendar:

class Dpc : DayPilotCalendar
{
  protected override void OnInit(InitArgs e)
  {
    var db = new DataClasses1DataContext();
    Events = from ev in db.events select ev;

    DataIdField = "id";
    DataTextField = "text";
    DataStartField = "eventstart";
    DataEndField = "eventend";

    Update();
  }
}  

We have loaded the calendar event data from a simple MS SQL table called "events" using a LINQ to SQL classes generated using Visual Studio 2010 wizard (DataClasses1.dbml).

LINQ to SQL

The "events" table has a very simple structure:

Events table structure

Database schema:

CREATE TABLE [dbo].[Event] (
    [id]         INT          IDENTITY (1, 1) NOT NULL,
    [text]       VARCHAR (50) NOT NULL,
    [eventstart] DATETIME     NOT NULL,
    [eventend]   DATETIME     NOT NULL,
    CONSTRAINT [PK_Event] PRIMARY KEY CLUSTERED ([id] ASC)
);

You can use your own database schema. In any case, it is necessary to tell DayPilotCalendar which fields to use. The following fields are required:

  • id (use DataIdField to map this field)
  • start (use DataStartField to map this field)
  • end (use DataEndField to map this field)
  • text (use DataTextField to map this field)

We load the event data to "Events" property and specify which fields the Calendar should use using the following code:

// load data
Events = from ev in db.events select ev;

// field mapping
DataIdField = "id";
DataTextField = "text";
DataStartField = "eventstart";
DataEndField = "eventend";

Calling Update() will send the calendar event data to the client and update the display:

ASP.NET Event Calendar for ASP.NET MVC Day View

And here is the complete code of the MVC controller that supplies the calendar event data to the client using AJAX:

using System;
using System.Linq;
using System.Web;
using System.Web.Mvc;
using DayPilot.Web.Mvc;
using DayPilot.Web.Mvc.Events.Calendar;

namespace DayPilotCalendarMvc.Controllers
{
  public class HomeController : Controller
  {
    public ActionResult Index()
    {
      return View();
    }

    public ActionResult Backend()
    {
      return new Dpc().CallBack(this);
    }

    class Dpc : DayPilotCalendar
    {
      protected override void OnInit(InitArgs e)
      {
        var db = new DataClasses1DataContext();
        Events = from ev in db.events select ev;

        DataIdField = "id";
        DataTextField = "text";
        DataStartField = "eventstart";
        DataEndField = "eventend";

        Update();
      }
    }
  }
}

4. Adding AJAX Drag&Drop Functionality (38 Lines of Code)

AJAX Event Calendar for ASP.NET MVC Drag&Drop

In order to enable the drag and drop functionality (event creating, moving, and resizing) we need to add the following lines to the view (four new lines):

@Html.DayPilotCalendar("dpc", new DayPilotCalendarConfig
{
  BackendUrl = Url.Content("~/Home/Backend"),
  EventMoveHandling = DayPilot.Web.Mvc.Events.Calendar.EventMoveHandlingType.CallBack,
  EventResizeHandling = DayPilot.Web.Mvc.Events.Calendar.EventResizeHandlingType.CallBack,
  TimeRangeSelectedHandling = DayPilot.Web.Mvc.Events.Calendar.TimeRangeSelectedHandlingType.JavaScript,
  TimeRangeSelectedJavaScript = "dpc.timeRangeSelectedCallBack(start, 
        end, null, { name: prompt('New Event Name:', 'New Event') });"
})

The controller must be extended as well. It will handle the events (EventMove, EventResize, and TimeRangeSelected) and update the database (34 new lines):

using System;
using System.Linq;
using System.Web.Mvc;
using DayPilot.Web.Mvc;
using DayPilot.Web.Mvc.Enums;
using DayPilot.Web.Mvc.Events.Calendar;

namespace DayPilotCalendarMvc.Controllers
{
    public class HomeController : Controller
    {
        public ActionResult Index()
        {
            return View();
        }

        public ActionResult Backend()
        {
            return new Dpc().CallBack(this);
        }

        class Dpc : DayPilotCalendar
        {
            DataClasses1DataContext db = new DataClasses1DataContext();

            protected override void OnInit(InitArgs e)
            {
                Update(CallBackUpdateType.Full);
            }

            protected override void OnEventResize(EventResizeArgs e)
            {
                var toBeResized = (from ev in db.Events where ev.id == Convert.ToInt32(e.Id) select ev).First();
                toBeResized.eventstart = e.NewStart;
                toBeResized.eventend = e.NewEnd;
                db.SubmitChanges();
                Update();
            }

            protected override void OnEventMove(EventMoveArgs e)
            {
                var toBeResized = (from ev in db.Events where ev.id == Convert.ToInt32(e.Id) select ev).First();
                toBeResized.eventstart = e.NewStart;
                toBeResized.eventend = e.NewEnd;
                db.SubmitChanges();
                Update();
            }

            protected override void OnTimeRangeSelected(TimeRangeSelectedArgs e)
            {
                var toBeCreated = new Event {eventstart = e.Start, 
                                             eventend = e.End, text = (string) e.Data["name"]};
                db.Events.InsertOnSubmit(toBeCreated);
                db.SubmitChanges();
                Update();
            }

            protected override void OnFinish()
            {
                if (UpdateType == CallBackUpdateType.None)
                {
                    return;
                }

                Events = from ev in db.Events select ev;

                DataIdField = "id";
                DataTextField = "text";
                DataStartField = "eventstart";
                DataEndField = "eventend";
            }
        }
    }
}

5. Bonus: Week View (+1 Line)

AJAX Event Calendar for ASP.NET MVC

Switching to week view is a simple as adding a single line of code to the view:

ViewType = DayPilot.Web.Mvc.Enums.Calendar.ViewType.Week,

It goes here:

@Html.DayPilotCalendar("dpc", new DayPilotCalendarConfig
{
  BackendUrl = Url.Content("~/Home/Backend"),
  ViewType = DayPilot.Web.Mvc.Enums.Calendar.ViewType.Week,
  EventMoveHandling = DayPilot.Web.Mvc.Events.Calendar.EventMoveHandlingType.CallBack,
  EventResizeHandling = DayPilot.Web.Mvc.Events.Calendar.EventResizeHandlingType.CallBack,
  TimeRangeSelectedHandling = DayPilot.Web.Mvc.Events.Calendar.TimeRangeSelectedHandlingType.JavaScript,
  TimeRangeSelectedJavaScript = 
    "dpc.timeRangeSelectedCallBack(start, end, null, { name: prompt('New Event Name:', 'New Event') });"
})

Other supported ViewType modes are WorkWeek and Days (custom number of days, set using Days property).

Month View (New in 1.3)

Monthly AJAX Event Calendar for ASP.NET MVC

See also the Monthly Event Calendar tutorial:

See Also

History

License

This article, along with any associated source code and files, is licensed under The Apache License, Version 2.0

Share

About the Author

Dan Letecky
Czech Republic Czech Republic
My open-source event calendar/scheduling AJAX controls:

DayPilot for JavaScript/HTML5/jQuery
DayPilot for ASP.NET
DayPilot for MVC
DayPilot for Java

You may also be interested in...

Pro
Pro

Comments and Discussions

 
QuestionDayPilot Lite or DHTMLX Pin
shitalumare21-Jan-16 11:31
membershitalumare21-Jan-16 11:31 
QuestionWeek view not working Pin
Member 1210178714-Nov-15 13:04
memberMember 1210178714-Nov-15 13:04 
AnswerRe: Week view not working Pin
Dan Letecky15-Nov-15 22:34
memberDan Letecky15-Nov-15 22:34 
QuestionAccessible according to WCAG 2.0? Pin
kevinsky10-Nov-15 5:17
memberkevinsky10-Nov-15 5:17 
QuestionGood tutorial, but needs more on model/database class Pin
Member 121017875-Nov-15 2:27
memberMember 121017875-Nov-15 2:27 
AnswerRe: Good tutorial, but needs more on model/database class Pin
Dan Letecky8-Nov-15 23:39
memberDan Letecky8-Nov-15 23:39 
GeneralRe: Good tutorial, but needs more on model/database class Pin
Member 121017879-Nov-15 13:15
memberMember 121017879-Nov-15 13:15 
QuestionThe db.events and db.SubmitChanges() Pin
Member 1152081410-Aug-15 14:51
memberMember 1152081410-Aug-15 14:51 
AnswerRe: The db.events and db.SubmitChanges() Pin
Dan Letecky8-Nov-15 23:46
memberDan Letecky8-Nov-15 23:46 
Questionnamespace Pin
echoCon11-Apr-15 9:42
memberechoCon11-Apr-15 9:42 
Questiona few variables don't work Pin
dieachtung25-Sep-14 11:09
memberdieachtung25-Sep-14 11:09 
QuestionThank you, Pin
Firdaus Muhammad3-Sep-14 21:50
memberFirdaus Muhammad3-Sep-14 21:50 
AnswerRe: Thank you, Pin
Firdaus Muhammad3-Sep-14 23:37
memberFirdaus Muhammad3-Sep-14 23:37 
GeneralRe: Thank you, Pin
Firdaus Muhammad18-Sep-14 16:03
memberFirdaus Muhammad18-Sep-14 16:03 
GeneralRe: Thank you, Pin
dieachtung25-Sep-14 11:15
memberdieachtung25-Sep-14 11:15 
GeneralRe: Thank you, Pin
Firdaus Muhammad30-Sep-14 15:57
memberFirdaus Muhammad30-Sep-14 15:57 
GeneralMy vote of 4 Pin
Member 1025738814-Aug-14 1:30
professionalMember 1025738814-Aug-14 1:30 
QuestionTutorial for VS 2013 Pin
Member 1092961014-Jul-14 5:01
memberMember 1092961014-Jul-14 5:01 
Questionhow to add Pin
cjnwan13-Dec-13 14:55
membercjnwan13-Dec-13 14:55 
AnswerRe: how to add Pin
Dan Letecky30-Jan-14 23:06
memberDan Letecky30-Jan-14 23:06 
QuestionChange of time in left side Pin
ArsalanAzeem3-Oct-13 3:37
memberArsalanAzeem3-Oct-13 3:37 
AnswerRe: Change of time in left side Pin
Dan Letecky24-Oct-13 1:15
memberDan Letecky24-Oct-13 1:15 
QuestionJavascript error Pin
JeffVaccaro30-Sep-13 11:24
memberJeffVaccaro30-Sep-13 11:24 
AnswerRe: Javascript error Pin
Dan Letecky2-Oct-13 8:18
memberDan Letecky2-Oct-13 8:18 
QuestionError Pin
Mirkox6830-Jul-13 23:49
memberMirkox6830-Jul-13 23:49 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.160927.1 | Last Updated 28 Jun 2016
Article Copyright 2012 by Dan Letecky
Everything else Copyright © CodeProject, 1999-2016
Layout: fixed | fluid