Adding and Removing Calendar Exceptions

Working with Calendar Exceptions

Aspose.Tasks helps you manage calendar exceptions. The Exceptions property exposed by the Calendar class represents a collection of CalendarException objects and is used to add, remove, or iterate through calendar exceptions.

This functionality is useful when working with non-standard working days, holidays, or recurring exception patterns in project calendars.

Example: Add and Remove Calendar Exceptions

The following example demonstrates how to:

• Add new calendar exceptions,
• Remove existing exceptions,
• Display the list of defined exceptions.

Project project = new Project("New Project.mpp");

// Remove an exception
Calendar cal = project.Calendars.ToList()[0];
if (cal.Exceptions.Count > 1)
{
    CalendarException exc = cal.Exceptions.ToList()[0];
    cal.Exceptions.Remove(exc);
}

// Add an exception
CalendarException calExc = new CalendarException();
calExc.FromDate = new System.DateTime(2009, 1, 1);
calExc.ToDate = new System.DateTime(2009, 1, 3);
cal.Exceptions.Add(calExc);

// Display exceptions
foreach (CalendarException calExc1 in cal.Exceptions)
{
    Console.WriteLine("From" + calExc1.FromDate.ToShortDateString());
    Console.WriteLine("To" + calExc1.ToDate.ToShortDateString());
}

Conclusion

Managing calendar exceptions is essential for ensuring that your project schedule reflects real-world constraints, such as holidays or planned downtimes. Aspose.Tasks for .NET makes it easy to programmatically handle these exceptions for accurate scheduling and resource planning.