API examples for newer versions

Please visit the latest API Examples documentation to view API examples for newer versions of Kentico.

private bool CreateWebPartCategory()
{

  WebPartCategoryInfo root = WebPartCategoryInfoProvider.GetWebPartCategoryInfoByCodeName("/");

 
    if (root != null)
    {
        // Create new web part category object
        WebPartCategoryInfo newCategory = new WebPartCategoryInfo();
 
        // Set the properties
        newCategory.CategoryDisplayName = "My new category";
        newCategory.CategoryName = "MyNewCategory";
        newCategory.CategoryParentID = root.CategoryID;
 
        // Save the web part category
        WebPartCategoryInfoProvider.SetWebPartCategoryInfo(newCategory);
 
        return true;
    }
 
    return false;
}

private bool GetAndUpdateWebPartCategory()
{

  // Get the web part category
  WebPartCategoryInfo updateCategory = WebPartCategoryInfoProvider.GetWebPartCategoryInfoByCodeName("MyNewCategory");

    if (updateCategory != null)
    {
        // Update the properties
        updateCategory.CategoryDisplayName = updateCategory.CategoryDisplayName.ToLower();
 
        // Save the changes
        WebPartCategoryInfoProvider.SetWebPartCategoryInfo(updateCategory);
 
        return true;
    }
 
    return false;
}

private bool GetAndBulkUpdateWebPartCategories()
{
    // Prepare the parameters
    string where = "CategoryDisplayName LIKE N'My new category%'";
 
    // Get the data
    DataSet categories = WebPartCategoryInfoProvider.GetCategories(where, null);
    if (!DataHelper.DataSourceIsEmpty(categories))
    {
        // Loop through the individual items
        foreach (DataRow categoryDr in categories.Tables[0].Rows)
        {
            // Create object from DataRow
            WebPartCategoryInfo modifyCategory = new WebPartCategoryInfo(categoryDr);

          // Update the properties
           modifyCategory.CategoryDisplayName = modifyCategory.CategoryDisplayName.ToUpper();

 
            // Save the changes
            WebPartCategoryInfoProvider.SetWebPartCategoryInfo(modifyCategory);
        }
 
        return true;
    }
 
    return false;
}

private bool DeleteWebPartCategory()
{
    // Get the web part category

  WebPartCategoryInfo deleteCategory = WebPartCategoryInfoProvider.GetWebPartCategoryInfoByCodeName("MyNewCategory");

    // Delete the web part category
    WebPartCategoryInfoProvider.DeleteCategoryInfo(deleteCategory);
 
    return (deleteCategory != null);
}