Modifying lists
Sitefinity 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 Querying lists.
For more information about finding specific lists, see Finding 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
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
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.
See Also