• Documentation
  Kentico development modelsInstallationUsing the Kentico interfaceDeveloping websitesConfiguring KenticoManaging usersSecuring websitesDeploying websitesManaging website contentMultilingual websitesMacro expressionsExternal utilitiesIntegrating 3rd party systemsCustom developmentE-commerce featuresOn-line marketing featuresCommunity featuresRelease notes - Kentico 12
• Tutorial
  Getting started with KenticoUsing the Kentico interfaceSelecting your tutorial pathSite development overviewPortal Engine developmentMVC developmentMVC business tutorialResource hub for marketers
• API Examples
  Content managementOn-line marketingE-commerceSocial and CommunityDevelopmentConfiguration

To make the concepts easier to understand for developers who are new to class development in Kentico, the documentation uses the term "class" to refer to the sum of all metadata defined by a type information instance. This terminology matches the classes that you create in the administration interface of the Modules application. Technically, each type information definition represents an "object type" rather than a class, and some of the default Kentico classes have multiple type information definitions.

Note: The comments and XML-based documentation in the Kentico API use the term "object type" for this purpose.

Configuring the type information for custom classes

After creating a new class for a custom module in the Modules application, you can generate basic Info and InfoProvider class files on the Code tab of the class editing interface. The default code of the Info class automatically includes:

• The RegisterObjectType assembly attribute.
• An object type name assigned to the OBJECT_TYPE constant (the value matches the class's code name by default).
• A basic ObjectTypeInfo definition (based on the fields defined for the class).

Click Save code to create the class files in your project. You can then adjust the type information in the code of the given Info class:

1. Open your Kentico solution in Visual Studio.

2. Edit the Info class representing your module class.

3. Navigate to the TYPEINFO field in the class's code.

4. Set the parameters in the ObjectTypeInfo constructor:

   • providerType - the Type⁠ (opens in a new tab) of the class's InfoProvider class. For example: typeof(ForumPostInfoProvider)

   • objectType

   • objectClassName

     Class identifiers

     Kentico classes have two different identifiers:

     • object type name (objectType parameter) - defined in the code of the Info class (typically in an OBJECT_TYPE constant). Serves as the primary identifier for the class. Use the object type name to select classes in the API, user interface components (UniGrid, UniSelector), REST calls, etc.
     • class code name (objectClassName parameter) - the code name assigned to the class in the Kentico administration interface. Identifies the class's definition in the database. For example, use the class code name when writing SQL where conditions for loading and filtering class records.Most classes use the same value for both identifiers, for example cms.user for user objects. The purpose of having two different identifiers is to allow management of classes with multiple type information definitions that share the same Info code and database class record.

   • idColumn - the name of the class field that stores the IDs of objects (i.e. the primary key column). Can be null in rare cases (for example binding classes without an identity column).

   • timeStampColumn - the name of the class field that stores the last modification date for objects. Can be null.

   • guidColumn - the name of the class field that stores the GUID identifiers⁠ (opens in a new tab) of objects. Can be null.

   • codeNameColumn - the name of the class field that stores the unique text identifiers of objects. Can be null for classes without a dedicated code name column.

   • displayNameColumn - the name of the class field that stores the visible names of objects (names used in the administration interface or on the live site). Can be null.

   • binaryColumn - the name of the class field that stores binary data for objects. Can be null.

   • siteIDColumn - the name of the class field that stores site IDs for site-related objects. Can be null. Only use site ID columns if you do not have a separate binding class for the site relationship.

   • parentIDColumn - the name of the class field that stores the IDs of parent objects. Set to null for classes without a parent class. See Setting parent-child relationships for classes to learn more.

   • parentObjectType - the object type name of the class's parent (as defined in the type information of the parent class). Set to null for classes without a parent class.

5. Use the initializer⁠ (opens in a new tab) to set other properties for the ObjectTypeInfo object.

   • You must always set the ModuleName property to the code name of the module under which the class belongs.
   • See Reference - ObjectTypeInfo for more information about the available properties.

You can use the type information to configure a large number of scenarios and options for your classes. See the following sections to learn about the most common scenarios:

Object type information example

The following code is an advanced ObjectTypeInfo example. This instance contains the metadata of the system's forum post objects (defined in the ForumPostInfo class).

Classes with multiple type information definitions

A single Info class can have multiple type information definitions representing different variants of the class. All variants share the same Info code and database class record. Each type information definition must be registered under a unique object type name using a separate RegisterObjectType assembly attribute.

An example from the Kentico system classes is CategoryInfo, which has one ObjectTypeInfo instance for global and site page categories and another for personal categories that belong to individual users.

We do not recommend creating custom classes with multiple type information definitions. Such classes require more complex type information settings or custom coding to achieve certain scenarios.