Begins asynchronous Send operation. Sends a mail message (MailMessage).

Namespace:  Rebex.Net
Assembly:  Rebex.Smtp (in Rebex.Smtp.dll)

Syntax

Visual Basic
Public Function BeginSend ( _
	mail As MailMessage, _
	sender As String, _
	recipients As String, _
	callback As AsyncCallback, _
	state As Object _
) As IAsyncResult
C#
public IAsyncResult BeginSend(
	MailMessage mail,
	string sender,
	string recipients,
	AsyncCallback callback,
	Object state
)

Parameters

mail
Type: Rebex.Mail..::..MailMessage
The message.
sender
Type: System..::..String
Message sender address (can be null or empty string).
recipients
Type: System..::..String
The list of recipients (can be null).
callback
Type: System..::..AsyncCallback
An optional asynchronous callback to be called when the operation is complete.
state
Type: System..::..Object
A user-provided object that identifies this particular asynchronous operation.

Return Value

An IAsyncResult that references the asynchronous operation.

Remarks

If the sender address argument is null (Nothing in Visual Basic), it is taken from the from the "Sender" header field or from the first address in the "From" field if the "Sender" is missing.
If the sender address argument is empty string, it means null sender - same behavior as if "<>" would be specified.
If the recipients argument is null (Nothing in Visual Basic), it overrides the list of recipients contained in the message. If the recipients argument is null, the list of recipients is extracted from "To", "Cc" and "Bcc" header fields.
The "Bcc" field is removed from message headers prior to sending. Set the AllowNullSender property to allow sending a mail message without a sender specified.

In builds for .NET 4.0 and higher, this method is available as an extension method. Add 'using Rebex.Legacy' (C#) or 'Import Rebex.Legacy' (VB.NET) to your code in order to use it.

Version Information

.NET Compact Framework

Supported in: 3.9, 3.5

See Also