Creates a new Category Node under another Category Node.
Namespace: Ingeniux.CMS
Assembly: Ingeniux.CMS.CSAPI (in Ingeniux.CMS.CSAPI.dll) Version: 9.0.565.0 (9.0.565)
Syntax
ICategoryNode CreateCategory( string name, string description, string externalId, string typeName, ICategoryNode parentNode )
Parameters
- name
- Type: SystemString
Name of new category - description
- Type: SystemString
Description of new category - externalId
- Type: SystemString
External ID of new category (for integration with another taxonomy system) - typeName
- Type: SystemString
Type name of new category - parentNode
- Type: Ingeniux.CMSICategoryNode
Parent node under which to place the new category; if not listed, creates new node as root category
Return Value
Type: ICategoryNodeNewly created category.
Exceptions
Exception | Condition |
---|---|
InvalidOperationException | When the operating user doesn't have the rights to Manage Taxonomy System or full access to parent node. |
Remarks
When the new Category Node is returned, it has not yet been stored in the database.
The operating user must have the rights to Manage Taxonomy System and also have full access to the specified parent node.
The taxonomy tree doesn't have the concept of orders.
The CreationLocale of the new category is the value of the CurrentLocale property.
See Also