SEARCH ASP FREE

ASP.Net: Calendar Web Control

Introduction

Calendar web control is provided by Microsoft.Net framework, it can display a calendar in a web page, user can navigate to any day in any year, user can also select dates, and it can also used to display some information, like appointment or schedule, in the calendar.

This article gives you an example application of programming on Calendar control. We have a XML file which has holiday data in year 2002, we use a DataSet object to read this XML file and mark them on the Calendar, when you select a date, the date and a description, if it is a holiday, will be displayed in a Label control.

In this article I will provide a step-by-step guide to show you how to:

Read XML file into a DataSet object
Display the DataSet data in a DataGrid
Program Calendar control to display information
Program Calendar control when user select a date

Requirement

You need the following things to do this work

Windows 2000 Pro or Server with service pack 2 as your operation system.
Visual Studio.Net is installed on your system

Create a XML file and read it into a DataSet object

Start your Visual Studio.Net, from the File menu, point to New, and then click Project to display the New Project dialog box.
Select Visual C# Projects in the Project Types pane, and then select ASP.Net Web Application. Name the project Calendar, then click OK. Visual Studio will add this project to Solution Explorer and display a new web page in the designer.
From the File menu, point to New, and then click File. The New File dialog box appears.
Select XML File and click Open.

Paste the following code into the editor below the XML declaration, (Right-click the editor and select Paste as HTML )

<holidays>

  <holiday>

    <Date>2002/1/1</Date>

    <Description>New Years' Day</Description>

  </holiday>

  <holiday>

    <Date>2002/1/15</Date>

    <Description>Martin Luther King</Description>

  </holiday>

  <holiday>

    <Date>2002/2/19</Date>

    <Description>President's Day</Description>

  </holiday>

  <holiday>

    <Date>2002/3/28</Date>

    <Description>Memorial Day</Description>

  </holiday>

  <holiday>

    <Date>2002/7/4</Date>

    <Description>Independence Day</Description>

  </holiday>

  <holiday>

    <Date>2002/9/3</Date>

    <Description>Labor Day</Description>

  </holiday>

  <holiday>

    <Date>2002/10/8</Date>

    <Description>Columbus Day</Description>

  </holiday>

  <holiday>

    <Date>2002/11/12</Date>

    <Description>Veterans Day</Description>

  </holiday>

  <holiday>

    <Date>2002/11/22</Date>

    <Description>Thanksgiving Day</Description>

  </holiday>

  <holiday>

    <Date>2002/12/25</Date>

    <Description>Christmas Day</Description>

  </holiday>

</holidays>

From the File menu, point to Save XMLFile1 As. Name the file holiday.xml and click Save.
In Solution Explorer window, select WebForm1.aspx, right click and select View Code.

Declare a DataSet Object, under public class WebForm1

protected DataSet dsHoliday = new DataSet("holiday");

In private void Page_Load method, write this:

dsHoliday.ReadXml("C:\Inetpub\wwwroot\Calendar\holiday.xml");

Now, you have read the XML file into your DataSet object.

Display the XML file in a DataGrid control

In order to prove the XML file is loaded into DateSet successfully, we use a DataGrid control to display the XML data in the page. You do not need this step if you don't want to confirm the data. However, I suggest you do it and then hide the DataGrid control by setting its Visible property to false .

From the Web Forms tab of the Toolbox, drag a DataGrid control onto the design view of WebForm1.aspx page.

Add the following three lines into the private void Page_Load method

DataGrid1.DataSource = dsHoliday;

DataGrid1.DataMember = "holiday";

DataGrid1.DataBind();

In Solution Explorer, right-click the page and choose Build and Browse. Confirm that a list of holiday is displayed in the grid.

Programming on the Calendar control

Now the XML data is already in our DataSet object, we need to do is mark them in the Calendar control by programming on the DayRender event of Calendar object. When the Calendar control is generating the calendar data, it raises an event you can handle. You create a event handler to hook this event, the control calls your event handler for each day as it is preparing the day for display, and you can then programmatically examine which date is being rendered and customize it appropriately.

From the Web Forms tab of the Toolbox, drag a Calendar control onto the design view of WebForm1.aspx page.
If you like you can change the appearance by clicking Auto Format... like under the Properties window, you can also change individual style properties to change the appearance.
In Properties window, click Event button, and select DayRender event, double click it. This will create an event handler in your code view of WebForm1.aspx page.
private void Calendar1_DayRender(object sender, System.Web.UI.WebControls.DayRenderEventArgs e)
Copy the following code into this Calendar1_DayRender method.
```
DataGrid1.DataSource = dsHoliday;

Style holidayStyle = new Style();

holidayStyle.ForeColor = System.Drawing.Color.Red;



foreach (DataRow myDataRow in dsHoliday.Tables["holiday"].Rows)

{

 string s = myDataRow["Date"].ToString();

 DateTime holiday_date = DateTime.Parse(s);

 if ( (e.Day.Date == holiday_date) && 

 (!e.Day.IsOtherMonth)               )

 {

 e.Cell.ApplyStyle(holidayStyle);

 }

} 
```
At first, set the DataSource of DataGrid1 to dsHoliday DataSet. Then create a Style to mark the calendar red for the holidays.
When Calendar control generate the calendar data, this DayRender event is fired for every day in the calendar, the date is in the parameter DayRenderEventArgs e, the above code compares the date in parameter e and every record in dsHoliday DataSet, if the date in parameter e equals to a date in dsHoliday record, then apply the holidayStyle to that date cell in calendar.
Build the project and run, you will see the Calendar control displayed in your browser, then navigate it to the months with a holiday, you will see the holiday date is displayed in red.

Programming When User Select a Date from Calendar

When user click on a date on a Calendar control, the Calendar control fires a SelectionChanged Event, developer can add a event handler and some code to program it. In this sample, when user click on a date, the date string, like Wednesday, July 17, 2002, will be displayed in a Label control, if that date is a holiday, the description of the holiday is also displayed.

In Properties window, click Event button, and select SelectionChanged event, double click it. This will create an event handler in your code view of WebForm1.aspx page.
private void Calendar1_SelectionChanged(object sender, System.EventArgs e)
In the design view of WebForm1.aspx, drag a Label control from the Toolbox.

Copy the following code into this Calendar1_SelectionChanged method.



string holiday_descr = "";

if (e != null){

System.Web.UI.WebControls.Calendar cl = 
        (System.Web.UI.WebControls.Calendar)sender;

foreach (DataRow myDataRow in dsHoliday.Tables["holiday"].Rows)

{

DateTime holiday_date = DateTime.Parse(myDataRow["Date"].ToString());

if ( cl.SelectedDate.Date == holiday_date ){

holiday_descr = ", " + myDataRow["Description"].ToString();

}

}

Label1.Text = cl.SelectedDate.Date.ToLongDateString() + holiday_descr;  

}

When the Calendar control fires this event, the parameter object sender is the Calendar control itself, the code above will cast the sender to Calendar object, then you can use SelectedDate property of Calendar control. The above code will go over all the records to find whether the selected date is a holiday, if it is, then get the description of the holiday.