Click here to Skip to main content
65,938 articles
CodeProject is changing. Read more.
Articles / web / HTML

DayPilot Scheduler Control for ASP.NET

4.91/5 (54 votes)
20 Jan 2016Apache4 min read 311.8K   8K  
Flexible open-source scheduler control (resource booking, project management, timeline and free/busy visualization, Gantt)

DayPilot Scheduler for ASP.NET

Live Demos

Features

Main features:

  • Simple and clean look
  • Multiple resources on the Y axis
  • Customizable time scale on the X axis (one cell = 1 minute, 1 hour, 1 day, 1 week ...)
  • Highlights business hours (customizable color)
  • Automatically handles concurrent events
  • Customizable event box (text, size, background color, duration bar...)
  • Customizable fonts and colors

Database connectivity:

  • DataSource and DataSourceID properties supported
  • SqlDataSource
  • XmlDataSource
  • DataTable
  • DataSet
  • ArrayList
  • and other sources...

Event handling:

  • Free time slot click event (automatic PostBack or manual JavaScript handling)
  • Calendar event click event (automatic PostBack or manual JavaScript handling)

Licensing:

  • Open-source (Apache License 2.0)

Compatibility:

  • Internet Explorer 9
  • Internet Explorer 10
  • Internet Explorer 11
  • Edge (the latest version)
  • Firefox (the latest version)
  • Opera (the latest version)
  • Safari (the latest version)
  • Chrome (the latest version)

Background Information

DayPilot Scheduler reuses the event arranging algorithms introduced in the DayPilot Calendar control (Outlook-like day and week view calendar/scheduler):

Open-Source Event Calendar for ASP.NET

DayPilot Calendar detects blocks of overlapping events so they could be displayed properly. The width of each event box is adjusted according to the number of concurrent events:

Calendar Overlapping Events

DayPilot Scheduler uses the same arranging algorithm but the layout is different:

  • The Scheduler shows the time on the X axis.
  • Event box height is fixed.
  • Concurrent events are handled by increasing the row height, not by shrinking the event box.

Scheduler Overlapping Events

This reduces the concurrency problem: The increasing number of concurrent events doesn't reduce readability.

See Also

Minimal Setup Sample

XML
<DayPilot:DayPilotScheduler 
  ID="DayPilotScheduler1" 
  runat="server" 
  DataSourceID="SqlDataSource1"
  DataStartField="start" 
  DataEndField="end" 
  DataTextField="name" 
  DataValueField="id" 
  DataResourceField="resource" 
  StartDate="2009-01-01"
  CellDuration="60" 
  Days="1" >
    <Resources> 
      <DayPilot:Resource Name="Room A" Value="A" /> 
      <DayPilot:Resource Name="Room B" Value="B" /> 
      <DayPilot:Resource Name="Room C" Value="C" /> 
    </Resources> 
</DayPilot:DayPilotScheduler>  

The first group properties defines the data binding:

  • DataSourceID
  • DataStartField (starting DateTime)
  • DateEndField (ending DateTime)
  • DataTextField (event text)
  • DataValueField (event id)
  • DataResourceField (resource id)

DataResourceField is important - the values from this column will be matched with the resource IDs (Resource.Value).

The second group defines the time range and scale:

  • StartDate (first visible day)
  • Days (number of visible days)
  • CellDuration (cell duration in minutes)

And finally, it's necessary to define the resources (rows):

  • Resource.Name (row name)
  • Resource.Value (row ID)

Usage Examples

Daily Scheduler

Daily Scheduler Control for ASP.NET

Settings:

C#
Days="1" 
CellDuration="60"

StartDate is set manually in the code behind:

C#
DayPilotScheduler1.StartDate = DateTime.Today; 

Weekly Scheduler

Weekly Scheduler Control for ASP.NET

Settings:

C#
Days="7"
CellDuration="1440" 

The first day of week is calculated using Week.FirstDayOfWeek helper:

C#
DayPilotScheduler1.StartDate = Week.FirstDayOfWeek(DateTime.Today, DayOfWeek.Monday);

Monthly Scheduler

Monthly Scheduler Control for ASP.NET

Settings:

C#
CellDuration="1440" 

In this case, it's necessary to set the Days property manually:

C#
DayPilotScheduler1.StartDate = 
    new DateTime(DateTime.Today.Year, DateTime.Today.Month, 1); 
DayPilotScheduler1.Days = 
    DateTime.DaysInMonth(DateTime.Today.Year, DateTime.Today.Month); 

Free/Busy Visualisation

Image 8

This view doesn't show event name (DataTextField is bound to an empty column).

Settings:

C#
DurationBarVisible="false"
EventBackColor="#4A71CE" 

Timeline Visualisation

Timeline Control for ASP.NET

In the timeline view, the resources are replaced with events in the row headers. There is always just one event per row.

Settings:

C#
DurationBarVisible="false"
EventBackColor="#CA2A50" 

Gantt

Gantt Chart for ASP.NET

DayPilot Scheduler can be switched to Gantt Chart mode using a single switch:

ViewType="Gantt"

In the Gantt mode, it will display each event in a separate row. See also a detailed explanation in the Gantt Chart Tutorial [code.daypilot.org].

CSS Themes

You can set the CSS theme using CssClassPrefix property. Several pre-built CSS themes are available. You can also browse a scheduler theme gallery or design your own theme using the online scheduler CSS theme designer.

White CSS Theme

Scheduler White CSS Theme

Green CSS Theme

Scheduler Green CSS Theme

Transparent CSS Theme

Scheduler Transparent CSS Theme

See Also

DayPilot Tutorials

History

License

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