---
title: OneClickSubmit
summary: API reference for OneClickSubmit.
status: draft
owner: SAIF Documentation Team
last_reviewed: 2026-08-17
library: SAIF.Presentation.Web.Controls.V2
reference_type: package
---

# OneClickSubmit

`OneClickSubmit` is a `Button` subclass that injects a client-side JavaScript guard preventing the same rendered button from triggering more than one form submission per page instance ([BR-V2-007](../../business-rules.md#br-v2-007-one-click-submit-buttons-block-duplicate-submission)).

## Purpose
- Prevent accidental duplicate submissions (e.g., from double-clicking or slow postbacks) by canceling the second and subsequent click events client-side.
- Apply a default CSS class (`NormalButton`) when the host page has not set one.

## Context
- Namespace: `SAIF.Presentation.Web.Controls.V2`
- Assembly/package: Compiled into `SAIF.BOF.Presentation.Web.Infragistics103`*

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| `DEFAULT_CSS_CLASS` | `Public Const DEFAULT_CSS_CLASS As String = "NormalButton"` | Default CSS class applied to the rendered button when the host page has not set `CssClass`. |

## Inherited public members

`OneClickSubmit` 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; this control sets it to the one-click guard. |
| `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
- `OnLoad` calls `InitializeControls()` (sets `OnClientClick = "return OneClickOnly()"`) and `BuildClientOneClickJavascript()` (registers the shared `WasClicked` flag variable and `OneClickOnly()` function scripts once per page).
- `Render` applies `DEFAULT_CSS_CLASS` only if `CssClass` is blank, then delegates to the base `Button.Render`.
- See [BR-V2-007](../../business-rules.md#br-v2-007-one-click-submit-buttons-block-duplicate-submission) for the enforced duplicate-submission rule.

## Constraints and usage notes
- The duplicate-submit guard relies entirely on client-side JavaScript (`WasClicked` variable); if JavaScript is disabled, the control provides no protection**.

> **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\OneClickSubmitControl.vb