SAIFWebMaskEdit¶
SAIFWebMaskEdit wraps the Infragistics WebMaskEdit control to add two read-only accessors, PhoneValue and TaxIdValue, that return cleaned string values instead of the raw masked text a consuming page would otherwise have to parse itself. PhoneValue strips a dangling phone-extension marker with no digits after it (BR-2), and both accessors return an empty string rather than mask placeholder characters when the field was left untouched (BR-3). Consuming code reads these properties server-side after postback rather than relying on client-side script.
Purpose¶
- Provide a cleaned phone-number value that omits a dangling extension marker when no extension digits were entered (BR-2).
- Provide a cleaned tax-ID value, and ensure both accessors return empty string (not mask placeholder text) for an untouched field (BR-3).
Context¶
- Namespace:
SAIF.Presentation.Web.Controls.V2 - Assembly/package:
SAIF.BOF.Presentation.Web.Infragistics103(source bundled into this package)*
Public members¶
| Member | Signature | Purpose |
|---|---|---|
PhoneValue |
Public ReadOnly Property PhoneValue As String |
Returns the cleaned phone number, stripping the trailing extension marker when no extension digits follow it, or empty string for an untouched field; see SAIFWebMaskEdit value accessors. |
TaxIdValue |
Public ReadOnly Property TaxIdValue As String |
Returns the raw tax-ID text, or empty string for an untouched field (BR-3). |
PHONE_EXT |
Public Const PHONE_EXT As String = "x" |
The literal extension-marker character PhoneValue checks for when deciding whether to strip a dangling extension indicator. |
Inherited public members¶
Members in this section are inherited from Infragistics.WebUI.WebDataInput.WebMaskEdit, the Infragistics v10.3 vendor base class this control wraps.
| Member | Signature | Purpose |
|---|---|---|
RawText |
Public ReadOnly Property RawText As String |
The unformatted raw text entered into the mask, including any mask placeholder characters; read by both PhoneValue and TaxIdValue (via RawText.Trim.Length) to detect an untouched field. |
Text |
Public Overridable Property Text As String |
The mask-formatted display text of the control's current value; read by PhoneValue's getter (via Text.Trim) to build the returned phone string, and returned directly by TaxIdValue when the field is non-empty. |
EditMask |
Public Property EditMask As String |
The Infragistics input mask pattern applied to the control (for example, a phone or tax-ID format mask). |
PromptChar |
Public Property PromptChar As Char |
The placeholder character Infragistics displays for unfilled mask positions; the character PhoneValue/TaxIdValue are designed to avoid returning for an untouched field. |
ClientID |
Public ReadOnly Property ClientID As String (from System.Web.UI.Control) |
The rendered client-side element ID of the control. |
Behavioral notes¶
PhoneValuecatchesSystem.Data.StrongTypingExceptionand returns empty string on that specific error path rather than propagating the exception.- Both accessors first check
RawText.Trim.Length = 0to detect an untouched field before doing any further parsing.
Constraints and usage notes¶
- Version-coupled to
Infragistics35.WebUI.WebDataInput.v10.3(version10.3.20103.2120). - These are server-side property getters read by consuming code after postback — unlike the other three types in this library, no client-side script is registered.
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.Infragistics103\SAIFWebMaskEdit.vb