Smtp.SubmittingMessageToPickupFolder Event

Occurs when the message is about to be saved into MailBee.NET Queue or IIS SMTP pickup folder.

public event SmtpSubmittingMessageToPickupFolderEventHandler SubmittingMessageToPickupFolder;

Event Data

The event handler receives an argument of type SmtpSubmittingMessageToPickupFolderEventArgs containing data related to this event. The following SmtpSubmittingMessageToPickupFolderEventArgs properties provide information specific to this event.

Property	Description
ActualRecipients	Gets or sets the list of recipients the message is addressed to.
ActualSenderEmail	Gets or sets the e-mail address of the sender of the mail message.
Filename	Gets or sets the filename of the message file to be saved in the pickup folder.
MailMessage	Gets the mail message which is about to be submitted to MailBee.NET Queue or IIS SMTP pickup folder.
MergeRowIndex	Gets the index of the data row used for mail merge of this message.
MergeTable	Gets the reference to the data table used for mail merge of this message.
PickupFolderName	Gets or sets the full physical path to MailBee.NET Queue or IIS SMTP pickup folder.
State	Gets a reference to the object which was supplied by the developer in state parameter of asynchronous methods of the mailer components.
SubmitIt	Gets or sets whether this message will be submitted to MailBee.NET Queue or IIS SMTP pickup folder.
Tag	Gets the tag assigned by the developer to SendMailJob of processing the given message.

Remarks

The developer can typically use this event for the following purposes:

Control whether particular messages should be skipped (not saved to the pickup folder). This can be useful when performing mail merge tasks. To make the message be skipped, set SubmitIt to false.
Fine-tune messages before they get saved to the pickup folder. This is also useful in mail merge tasks if the developer wants to perform some actions on the messages which had already been merged. You can change properties of the mail message itself (returned by MailMessage property), change ActualSenderEmail or ActualRecipients.
Change the pickup folder name or specify your own filename of the message file to be saved. This is useful if there is more than one pickup folder. Set Filename or PickupFolderName properties for this.

Note If you changed the message sender or recipients via modification of the e-mail message itself (MailMessage property), you should also update ActualSenderEmail or ActualRecipients as well (for instance, set them to a null reference (Nothing in Visual Basic) to tell MailBee to grab these values from MailMessage property. Alternatively, if you only changed ActualSenderEmail or ActualRecipients, the corresponding message headers won't be changed (the message will be sent from or to addresses different from those specified in the message headers).

Example

The example is available at SubmitJobsToPickupFolder topic.

Smtp.SubmittingMessageToPickupFolder Event

Event Data

Remarks

Example

See Also