Skip to content

SAIFMessage

Displays a one-row status/validation message with an icon automatically chosen from keywords in the message text, so callers don't need to pick an icon themselves BR-V2-042.

Purpose

  • Selects the error icon when the text contains an error keyword, ahead of any other keyword match BR-V2-042.
  • Falls back to the warning icon for unmatched text so a message is never left iconless BR-V2-043.
  • Ensures its client script is included only once per page even with multiple SAIFMessage instances BR-V2-037.

Context

  • Namespace: SAIF.Presentation.Web.Controls.V2
  • Assembly/package: SAIF.Presentation.Web.Controls.V2 (packaged in SAIF.BOF.Presentation.Web.Infragistics111.nuspec)

Public members

Member Signature Purpose
Text Public Property Text As String The message text; also used to auto-select the rendered icon by keyword.
DisplayImage Public Property DisplayImage As SAIFMessage.Images Overrides automatic icon selection with an explicit Images value.
RenderControl Public Overrides Sub RenderControl(writer As HtmlTextWriter) Renders the icon+label table; on failure, writes the exception message, source, and stack trace into the page instead of throwing.

Behavioral notes

  • If rendering fails, the exception message, source, and stack trace are written directly into the rendered output rather than propagated*.

Note: Statements marked with * were inferred from code structure, naming conventions, or contextual evidence where direct confirmation was not available in source artifacts.

Sources

  • SAIF.Presentation.Web.Controls.V2/SAIFMessage.vb