How to: Register a Windows Client Control Add-in

  • Article

A Microsoft Dynamics NAV Windows client control add-in is delivered as a Microsoft .NET Framework–based assembly, which is a .dll file. An assembly for Microsoft Dynamics NAV Windows client add-ins can contain more than one control add-in where each control add-in has a unique name. Before you can use a control add-in on pages, you use the development environment to register it on the Control Add-ins page of your Dynamics NAV database.

To register a control add-in, provide the following information.

Information Description
Control add-in name The name is defined in the assembly's source code by the Microsoft.Dynamics.Framework.UI.Extensibility.ControlAddInExportAttribute attribute value for control add-in class definition, as shown in the following example code snippet.

C#

[ControlAddInExport("MyCompany.MyProduct.FieldPopupAddin")] public class MyFieldPopupAddin : StringControlAddInBase, IStringControlAddInDefinition

In this example, the control add-in name is MyCompany.MyProduct.FieldPopupAddin. For more information, see How to: Create a Windows Client Control Add-in.
Public key token The public key token is a 16-character key that is given to the assembly when it is built and signed in Microsoft Visual Studio. To determine the public token key, run the Microsoft .NET Strong Name Utility (sn.exe) on the assembly. For more information, see How to: Determine the Public Key Token of the Windows Client Control Add-in and .NET Framework Assembly and Strong-Named Signing.

To register a Microsoft Dynamics NAV Windows client control add-in

  1. Open Microsoft Dynamics NAV Windows client.

  2. In the Search box, enter Control Add-ins and then choose the related link.

  3. On a blank line on the Control Add-ins page, fill in the Control Add-In Name and Public Key Token fields.

  4. Close the Control Add-ins page.

    You can also register and manage the control add-in by using the New-NAVAddin cmdlet, Set-NAVAddin cmdlet, Get-NAVAddin, or Remove-NAVAddin cmdlets from the Microsoft Dynamics NAV Administration Shell.

See Also

Installing and Configuring Windows Client Control Add-ins on Pages
How to: Set Up a Windows Client Control Add-in on a Page
How to: Install a Windows Client Control Add-in Assembly
How to: Determine the Public Key Token of the Windows Client Control Add-in and .NET Framework Assembly
Developing Windows Client Control Add-ins
Windows Client Control Add-in Overview
Walkthrough: Creating and Using a Windows Client Control Add-in