Delete list items

Sitefinity CMS allows you to delete list items through the Lists API.

When deleting a list item, you must perform the following:

  1. Get the list item.

    First, you must get the master version of the list item corresponding to the specified ID.

    For more information about querying list items, see For developers: Query list items

    For more information about finding specific list items, see For developers: Find list items.

  2. Delete the list item.

    After you get the master version of the list item, you delete it.

  3. Save the changes.

    Finally, you must save the changes.

To delete a list item you can use the Native API or the Fluent API.

NOTE: The code examples below work with the ID of the master version of the list item. Deleting the master version also deletes the other versions of the item. For more information about deleting items using the ID of the live version, see For developers: Delete content.

Deleting a list item by its ID

The following examples delete a list item by the ID of its master version.

Native API

 

First, you initialize the ListsManager. Then, you get the master version of the list item using GetListItems and filtering based on the Idproperty.

For more information about querying list items, see For developers: Query list items

For more information about finding specific list items, see For developers: Find list items.

To delete the list item, you call the DeleteListItem method passing the master version as argument. Finally, you save the changes.

Fluent API

 

First, you initialize the plural facade of the list item using App.WorkWith().ListItems(). Then, you filter based on the Id property to assure that the list item exists.

For more information about querying list items, see For developers: Query list items

For more information about finding specific list items, see For developers: Find list items.

To get the master version of the list item, you use the singular facade.

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

To delete the list item, you use the Delete method of the facade. Finally, you save the changes.

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

Web Security for Sitefinity Administrators

The free standalone Web Security lesson teaches administrators how to protect your websites and Sitefinity instance from external threats. Learn to 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?