Loading custom classes from App_Code

By preparing custom classes that inherit from an appropriate base class, you can extend the functionality of Kentico. This approach allows you to implement the following types of objects:

• Form controls and inherited form control extenders
• Integration connectors
• Marketing automation actions
• Notification gateways
• Payment gateways
• Scheduled tasks
• Custom Smart search components:
  • Search indexes
  • Index analyzers
• Translation services
• Workflow actions
• UI extenders

Registering custom classes in the App_Code folder

If you decide to add custom classes into App_Code, you need to register each class to allow the system to load it:

1. Edit your custom class.
2. Add a using statement for the CMS namespace.
3. Add the RegisterCustomClass assembly attribute above the class declaration (for every App_Code class that you want to register).

using CMS;

// Ensures that the system loads an instance of 'CustomClass' when the 'MyClassName' class name is requested.
[assembly: RegisterCustomClass("MyClassName", typeof(CustomClass))]

...

public class CustomClass
{
    ...
}

The RegisterCustomClass attribute accepts two parameters:

• The first parameter is a string identifier representing the name of the class.
• The second parameter specifies the type of the class as a System.Type object. When the system requests a class whose name matches the first parameter, the attribute ensures that an instance of the given class is provided.

Once you have registered your custom classes, you can use them as the source for objects in the system. When assigning App_Code classes to objects in the administration interface, fill in the following values:

• Assembly name: (custom_classes)
• Class: must match the value specified in the first parameter of the corresponding RegisterCustomClass attribute