Developer's Guide - EPiServer World

16 | Developer’s Guide EPiServer Community 3.1
2.4 Categories
The Category system allows for categorization of objects that implements the IcategorizableEntity interface. In this
tutorial we use a Blog as an example.
The use the Category system, first import the necessary namespaces:
using StarCommunity.Core.Modules;
using StarCommunity.Core.Modules.Security;
using StarCommunity.Core.Modules.Categories;
using StarCommunity.Modules.Blog; //only for this example.
2.4.1 Add a category
Categories may be added programmatically or in the administration interface. Categories a stored in a tree structure as
shown in the example below.
//Create a new (root) category
ICategory category = new Category("cars");
//Commit to database
ICategory rootCategory = CategoryHandler.AddCategory(category);
//Create a new sub category to root category
ICategory subCategory = new Category("Volvo", rootCategory);
//Commit to database
CategoryHandler.AddCategory(subCategory);
2.4.2 Remove a category
Categories may be removed programmatically or in the administration interface. You can get a category by id, by path
or by name. This is an example to remove a category by its path.
//Get the category to remove by path
ICategory category = CategoryHandler.GetCategory("cars/Volvo");
//Remove the category
CategoryHandler.Removecategory(category);
2.4.3 Categorize an entity
A categorizable entity can have one or more categories added to it.
//Get the blog to categorize by id
Blog blog = (Blog)BlogHandler.GetBlog(1).Clone();
© EPiServer AB