Modify lists
Sitefinity CMS allows you to modify a list through the Lists API.
When modifying a list, you must perform the following:
-
Get the list.
First, you get the list.
For more information about querying lists, see For developers: Query lists.
For more information about finding specific lists, see For developers: Find lists.
-
Modify the list.
After you get the list, you modify it.
-
Save the list.
Finally, you must save the changes.
Modifying a list by its ID
The following examples modify a list by its ID.
Native API
using System;
using System.Linq;
using Telerik.Sitefinity.Modules.Lists;
using Telerik.Sitefinity.Lists.Model;
namespace SitefinityWebApp
{
public class ModifyLists_ModifyListNativeAPI
{
public void ModifyListNativeAPI(Guid listId, string newTitle)
{
ListsManager listManager = ListsManager.GetManager();
// Get the list
List list = listManager.GetLists().Where(l => l.Id == listId).FirstOrDefault();
if (list != null)
{
// Modify the list
list.Title = newTitle;
// Save changes
listManager.SaveChanges();
}
}
}
}First, you get an instance of the ListsManager class. Then, you use GetLists to assure that the list with the specified Id exists.
Then, you modify the title of the list with newTitle. Finally, you call SaveChanges to save all changes.
Fluent API
using System;
using Telerik.Sitefinity;
namespace SitefinityWebApp
{
public class ModifyLists_ModifyListFluentAPI
{
public void ModifyListFluentAPI(Guid listId, string newTitle)
{
int count = 0;
// Check whether the item exists.
App.WorkWith().Lists().Where(l => l.Id == listId).Count(out count);
if (count > 0)
{
// Get the list
App.WorkWith().List(listId).Do(l =>
{
// Modify the list
l.Title = newTitle;
}).SaveChanges();
}
}
}
}First, you check whether a list with the specified ID exists using the plural facade of the list.
**NOTE:**If there is no item with the specified Id, List(listId) throws an exception of type ItemNotFoundException.
Then, you modify the title of the list with newTitle. Finally, you call SaveChanges to save all changes.
