Skip to content

Migrating from earlier versions of ical.net

Jump to bottom
Rian Stockbower edited this page Apr 7, 2018 · 3 revisions

Migrating to v4

ical.net v4+ targets .NET Standard 1.3, and migrating to the latest version(s) shouldn't take long if you're targeting .NET Core 1.3+ or .NET Framework 4.6+.

  • Event is now CalendarEvent
  • At this point, most of the pointless interfaces (IEvent, ICalendarCollection, etc.) are gone. Use the concrete types instead, which is usually a matter of removing the I prefix. IRecurrencePattern is now RecurrencePattern, for example.
  • Lots of namespace reorganization. You'll want to use IntelliSense to import the new namespaces. In many cases, the type names haven't changed, but their location has.
  • The ical.net.Collections assembly is completely gone.
  • The ANTLR-based parser is gone in favor of chescock's SimpleDeserializer which is about twice as fast, and is quite a lot simpler to read and understand.
  • CalendarCollection.Load() loads a CalendarCollection.
  • Calendar.Load loads a Calendar.
  • CalendarComponent.Load<T>() loads whatever type you're looking for.
  • See the release notes for additional v4 details.

Migrating to v3

Lots of interfaces were deleted. This release was about getting a .NET Core/Standard version published, and having a release that removed a bunch of mostly hidden public interfaces that shouldn't exist, or should have been internal.

Migrating from dday.ical

See the Migrating from dday.ical guide

Clone this wiki locally