ITaxonomyManager.Associate Method

ITaxonomyManagerAssociate Method

Ingeniux CMS Content Store API

Associates a Page with a given collection of Category Nodes.

Namespace: Ingeniux.CMS
Assembly: Ingeniux.CMS.CSAPI (in Ingeniux.CMS.CSAPI.dll) Version: 9.0.565.0 (9.0.565)

Syntax

void Associate(
	IPage page,
	ICategoryNode[] categories
)

Sub Associate ( 
	page As IPage,
	categories As ICategoryNode()
)

void Associate(
	IPage^ page, 
	array<ICategoryNode^>^ categories
)

abstract Associate : 
        page : IPage * 
        categories : ICategoryNode[] -> unit

Parameters

page: Type: Ingeniux.CMSIPage
Page to associate
categories: Type: Ingeniux.CMSICategoryNode
Category node collection to associate with the page

Exceptions

Exception	Condition
ArgumentNullException	When the "page: parameter is null
ArgumentException	When any of the categories are not from this session.
InvalidOperationException	When user doesn't have rights to manage taxonomy; doesn't have full acess to page; or doesn't have at least read-only access to any of the categories.

Remarks

The "page" parameter value cannot be null. Otherwise, an error is thrown.

The "categories" parameter ignores all null values in the colleciton, but all the categories must be from the current session. Otherwise, an error is thrown.

The current user must either be an administrator or have permissions to manage the taxonomy system. Otherwise an error is thrown.

The current user must have full access to the page node and at least read-only access to provided categories. Otherwise, an error is thrown.

Reference

ITaxonomyManager Interface

Ingeniux.CMS Namespace

ITaxonomyManagerUnassociatePage(IPage)