'Declaration Public Class UltraWebCalcManager Inherits System.Web.UI.Control Implements Infragistics.WebUI.CalcEngine.IUltraCalcManager
public class UltraWebCalcManager : System.Web.UI.Control, Infragistics.WebUI.CalcEngine.IUltraCalcManager
Developers can drag the _CALCMANAGER_ from the toolbox in their IDE onto the design view to enable UltraCalc functionality to any controls on the page. A placeholder will appear on the page at design-time only.
The _CALCMANAGER_ serves as the bridge connecting any Control elements on an ASP.NET Page with the Calc Engine. All communication between participating calculable elements (called "references" because they implement, directly or indirectly, the IUltraCalcReference interface) and the engine takes place through the IUltraCalcManager interface. This design permits Control instances that may not depend on the Calc Engine to take full advantage of it's features.
During run-time, developers may manually ReCalc the calculation network through the _CALCMANAGER_, or this will be accomplished automatically when references have been added to or removed from the calculation network and values have changed.
Developers are encouraged to temporarily disable recalculations while adding (or removing) a large batch of references at one time, using SuspendCalc, and then re-enable calculations with ResumeCalc.
The _CALCMANAGER_ element also exposes two collections that help developers take immediate advantage of some of the Calc Engine's features. These are the NamedReferences collection and the CalcSettingsCollection.
The NamedReferences collection lets developers assign meaningful names to represent formulas (that may combine values from one or more other references). An example of where a named reference would be useful is Ohm's Law to calculate the voltage based on current and resistance values specified by other elements on the Page. In this example, "Voltage" would be the name of the reference, and it's Formula would refer to a "Current" reference multiplied by a "Resistance" reference. The Calc Engine will update the value of this NamedReference whenever either of the other two references' values change. Named references are always rooted at the _CALCMANAGER_ (they are not contained in other references), so the UltraCalc reference name in the example would be "//Voltage" where the "//" in the grammar represents the root.
The CalcSettingsCollection contains a proxy for every extended, calculable element on the Page. These CalcSettings identify one simple, bindable property on a calculable element that is to serve as either the source of a value within a calculation, or as the recipient of a formula result. By default, these extended properties should appear on calculable elements at design-time, but if it's necessary to manipulate any of these settings at run-time then developers will find the proxy objects encapsulating the additional information attached to calculable elements in this collection.
Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2