The content in this topic only applies to Microsoft Dynamics NAV 2009 SP1. For Microsoft Dynamics NAV 2009 content, see Developer and IT Pro Help for Microsoft Dynamics NAV 2009.

Similar to other field controls on a page, a RoleTailored client control add-in can bind with data in the Microsoft Dynamics NAV database. This allows you to create control add-ins that can display and update data in the database. Data binding is accomplished through Microsoft Dynamics NAV Server with the SourceExpr Property of the field control that is applied with the control add-in as illustrated in the following figure.

RoleTailored client control add-in data binding

The control add-in must implement the Microsoft.Dynamics.Framework.UI.Extensibility.IValueControlAddInDefinition interface that exposes the Microsoft.Dynamics.Framework.UI.Extensibility.IValueControlAddInDefinition.Value property. When a control add-in is instantiated on a page, the SourceExpr property value is passed to the control add-in Microsoft.Dynamics.Framework.UI.Extensibility.IValueControlAddInDefinition.Value property.


The SourceExpr property value can be passed to Microsoft.Dynamics.Framework.UI.Extensibility.IValueControlAddInDefinition.Value property multiple times while a page is open, depending on application code or state in the RoleTailored client.

The SourceExpr property can be a field in a database table or a C/AL global variable. Control add-ins support text string (System.String) and object (Object) data types.

For more information about implementing the Microsoft.Dynamics.Framework.UI.Extensibility.IValueControlAddInDefinition interface, see How to: Create a RoleTailored Client Control Add-in.

For more information about setting the SourceExpr property for a control add-in, see How to: Set up a RoleTailored Client Control Add-in on a Page.

See Also