Topics

All topics

Modify events

Sitefinity CMS allows you to modify an event through the Events API.

When modifying an event, you must perform the following:

  1. Get the master version.
    Get the master version of the event. When you modify an event, you must not work on its live version.
  2. Get a temp version.
    Check out the master version to get a temp version of the event. This is the version you must modify.
  3. Modify the temp version.
    Use the temp version to modify the event.
  4. Update the master version.
    Check in the temp version to transfer the changes to the master version.
  5. Update the live version.
    Publish the master version to transfer the changes to the live version.

The examples below modify an event by the ID of its master version. For more information about working with the ID of the live version, see For developers: Edit content.

Modify an event by its ID

The following examples modify an event by the ID of its master version:

Native API

First, you get an instance of the EventsManager class. Then, you get the event corresponding to the ID. If the event exists, you get its master version by calling the Lifecycle.GetMaster method.

For more information about querying events, see For developers: Query events.
For more information about finding specific events, see For developers: Find events.

Then, you call Lifecycle.CheckOut with the master version as argument to get a temp version of the item. You modify the content of the temp version with newContent. Then, you call Lifecycle.CheckIn with the temp version as argument to transfer the changes to the master version. By default, calling the CheckIn method deletes the temp version. Then, you call Lifecycle.Publish with the master version as argument to transfer the changes to the live version. Finally, you call SaveChanges to save all changes.

Fluent API

First, you check whether an item with the specified ID exists. Then, you get the master version with the specified ID using the singular facade of the event.

NOTE: If there is no item with the specified Id, Event(masterEventId) throws an exception of type ItemNotFoundException.

For more information about querying events, see For developers: Query events.
For more information about finding specific events, see For developers: Find events.

To get a temp for the item, you use the CheckOut method of the facade. Then, you modify the content with newContent in the Do method of the temp facade. You call CheckIn to transfer the changes to the master version of the item. Then, you call Publish to transfer the changes to the live version. Finally, you call SaveChanges to save all changes.
NEW TO SITEFINITY?

Want to learn more?

Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.

Get started with Integration Hub | Sitefinity Cloud | Sitefinity SaaS

This free lesson teaches administrators, marketers, and other business professionals how to use the Integration hub service to create automated workflows between Sitefinity and other business systems.

Web Security for Sitefinity Administrators

This free lesson teaches administrators the basics about protecting yor Sitefinity instance and its sites from external threats. Configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.

Foundations of Sitefinity ASP.NET Core Development

The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.

Was this article helpful?

Next article

Delete events