SAIFButton¶
SAIFButton is a Button subclass that adds an AJAX "busy indicator" client-side convention: when enabled, it applies an indicator CSS class, tags itself with a DisableFormControls attribute, and registers Button.js so partial postbacks show visual feedback and can optionally disable other form controls while processing.
Purpose¶
- Give buttons a consistent "in-progress" visual indicator during AJAX partial postbacks without requiring each page to wire this up manually.
- Optionally disable other form controls while the button's postback is in flight, preventing conflicting user input.
Context¶
- Namespace:
SAIF.Presentation.Web.Controls.V2 - Assembly/package: Compiled into
SAIF.BOF.Presentation.Web.Infragistics103*
Public members¶
| Member | Signature | Purpose |
|---|---|---|
DisableFormControlsOnClick |
Public Property DisableFormControlsOnClick As Boolean |
Determines whether other form controls are disabled client-side while this button's click is being processed; defaults to True. |
EnableIndicator |
Public Property EnableIndicator As Boolean |
Turns on the AJAX busy-indicator CSS class and registers the supporting client script; defaults to True. |
Inherited public members¶
SAIFButton inherits from Button (System.Web.UI.WebControls), a framework base class rather than a documented SAIF dependency library.
| Member | Signature | Purpose |
|---|---|---|
CausesValidation |
Public Property CausesValidation As Boolean |
Determines whether clicking the button triggers ASP.NET validator checks before postback. |
CommandArgument |
Public Property CommandArgument As String |
Caller-supplied payload passed through command events so pages can distinguish which action fired. |
CommandName |
Public Property CommandName As String |
Semantic command name raised during command handling for higher-level page logic. |
OnClientClick |
Public Property OnClientClick As String |
Client-side JavaScript executed before postback, commonly used to add confirmation or other click guards. |
PostBackUrl |
Public Property PostBackUrl As String |
Cross-page postback target when the button submits to another page. |
Text |
Public Property Text As String |
Caption rendered on the button face. |
UseSubmitBehavior |
Public Property UseSubmitBehavior As Boolean |
Controls whether the button renders as a native submit element or uses ASP.NET postback script. |
ValidationGroup |
Public Property ValidationGroup As String |
Validator group name evaluated when the button is clicked. |
Click |
Public Event Click As EventHandler |
Standard button click event raised after the postback reaches the server. |
Standard Button/Control members (ID, ClientID, Controls, Visible, DataBind, FindControl, etc.) are not re-documented here as they are unmodified framework behavior**.
Behavioral notes¶
SAIFButton_InitsetsCssClassto"SAIFButton", or"SAIFButtonIndicator"plus aDisableFormControlsattribute whenEnableIndicatoris true, and registersButton.jsin that case.- The
Button.jsscript referenced is not present in this project folder; its exact client-side indicator behavior could not be verified from this library's source**.
Constraints and usage notes¶
- Requires
Button.jsto be deployed at/Resources/Scripts/Controls/Button.jsin the hosting application for the indicator behavior to function.
Note: Statements marked with * were inferred from code structure, naming conventions, or contextual evidence where direct confirmation was not available in source artifacts. Statements marked with ** could not be confirmed; treat as unknown until verified.
Sources¶
- SAIF.Presentation.Web.Controls.V2\SAIFButton.vb