iCal.NET Documentation

iCal.NET is a library for working with the iCalendar (RFC 5545) standard in .NET. It provides tools for:

• RFC 5545 Compliance: Ensures compatibility with standard calendaring applications.
• Event Management: Programmatic creation, modification, and management of calendar events.
• Recurrence Rules: Support for complex scheduling and recurring events.
• Serialization/Deserialization: Converting calendar data to and from .ics files.
• Time Zone Support: Handling events across different time zones.
• Attachments: Adding attachments to events and invites.

To use iCal.NET in your .NET project, install the NuGet package using the .NET CLI.

dotnet add package iCal.NET

iCal.NET v5 is a comprehensive rewrite focused on performance (reducing memory usage by up to 50% compared to v4), correctness, and usability.

Note: v4 is out of support and will not receive further updates. It is highly recommended to use the v5 packages.

For detailed migration steps, refer to the following resources in the project wiki:

• API Changes Document
• Migration Guide for v4 to v5

The iCal.NET Wiki provides detailed examples for several common tasks:

• Simple event with a recurrence: Creating basic events that repeat.
• Deserializing an ics file: Loading existing calendar data from a file.
• Working with attachments: Managing files attached to calendar items.
• Working with recurring elements: Handling complex recurrence logic.
• Concurrency scenarios and PLINQ: Using the library in high-performance or parallel processing environments.