clsMailMessage

clsMailMessage wraps a legacy SOAP mail web service (SAIFMail.clsSAIFMessage) so consuming applications can send outbound email with or without an attachment through a single, Shared-only API, and separately provides a generic file-streaming download helper (StreamDownloadFile) that is independent of the mail functionality.

Purpose

• Send outbound email (with or without a message body) through the legacy SOAP mail service, whose endpoint URL is resolved at runtime from configuration, per the Send email via legacy SOAP mail service operation.
• Send outbound email with an attachment supplied as a stream, byte array, or file path.
• Stream an existing file on disk to the HTTP response as a downloadable attachment, setting content type only for .txt/.csv extensions per BR-CMM-001.
• Provide byte-array conversion helpers (GetFileAsBytes, GetStreamAsBytes) used internally by the attachment-sending overloads.

Context

• Namespace: SAIF.Presentation.Web.Core.Utilities
• Assembly/package: SAIF.Presentation.Web.Core.Infragistics103 (merged into SAIF.BOF.Presentation.Web.Infragistics103 NuGet package)

Public members

Member	Signature	Purpose
STANDARD_DISCLAIMER	Public Const STANDARD_DISCLAIMER As String	Standard confidentiality disclaimer text intended for inclusion in outbound email bodies.
DO_NOT_REPLY	Public Const DO_NOT_REPLY As String = "This is an auto-generated email. Please do not reply to this email address."	Standard auto-generated-email notice intended for inclusion in outbound email bodies.
StreamDownloadFile	Shared Sub StreamDownloadFile(Filename As String, inPage As AppViewPageBase)	Streams the given file to the current page's HTTP response as a download, setting Content-Type only for .txt/.csv extensions per BR-CMM-001, then calls Response.End().
SendMail	Overloads Shared Function SendMail(inToAddress As String, inFromAddress As String, inSubject As String) As Boolean	Sends a subject-only email via the legacy SOAP mail service; effectively always returns the default False* (no explicit Return statement).
SendMail	Overloads Shared Function SendMail(inToAddress As String, inFromAddress As String, inSubject As String, inMessage As String) As Boolean	Sends an email with subject and HTML-capable body via the legacy SOAP mail service; effectively always returns the default False*.
SendMailWithAttachment	Overloads Shared Function SendMailWithAttachment(inToAddress As String, inFromAddress As String, inSubject As String, inStream As Stream, inAttachName As String) As Boolean	Sends an email with an attachment supplied as a stream (no body); effectively always returns the default False*.
SendMailWithAttachment	Overloads Shared Function SendMailWithAttachment(inToAddress As String, inFromAddress As String, inSubject As String, inMessage As String, inStream As Stream, inAttachName As String) As Boolean	Sends an email with subject, body, and a stream attachment; effectively always returns the default False*.
SendMailWithAttachment	Overloads Shared Function SendMailWithAttachment(inToAddress As String, inFromAddress As String, inSubject As String, inMessage As String, inFilePath As String, inAttachName As String) As Boolean	Sends an email with subject, body, and an attachment loaded from a file path; effectively always returns the default False*.
SendMailWithAttachment	Overloads Shared Function SendMailWithAttachment(inToAddress As String, inFromAddress As String, inSubject As String, inMessage As String, inAttachment() As Byte, inAttachName As String) As Boolean	Sends an email with subject, body, and a pre-loaded byte-array attachment; effectively always returns the default False*.
GetFileAsBytes	Shared Function GetFileAsBytes(inPath As String) As Byte()	Reads the given file path fully into a byte array for use as a mail attachment.
GetStreamAsBytes	Shared Function GetStreamAsBytes(inStream As Stream) As Byte()	Reads the given stream fully into a byte array for use as a mail attachment; returns Nothing if inStream is Nothing.

Behavioral notes

• All six SendMail/SendMailWithAttachment overloads instantiate New SAIFMail.clsSAIFMessage, set its SOAP endpoint .Url from AppGlobal.EnvironmentService.GetConfigSetting("LegacyMailWebServiceUrl"), invoke the corresponding proxy method, then dispose the proxy — with no error handling around the SOAP call.
• None of the six send methods contain an explicit Return statement in their observed bodies, so they effectively always return the default False*.
• StreamDownloadFile leaves Content-Type as an empty string for any file extension other than .txt/.csv, per BR-CMM-001.

Constraints and usage notes

• The SAIFMail.clsSAIFMessage SOAP proxy type used by every send method is not defined in this project's own references; it is presumed supplied transitively through one of this project's ProjectReferences**.
• StreamDownloadFile requires an AppViewPageBase-derived page instance to resolve the physical file path (Server.MapPath) and write to the HTTP response.
• All members are Shared; this class holds no instance state.

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.Core.Infragistics103\clsMailMessage.vb