MailBee.NET Objects 3.1

Smtp Members

Smtp overview

Public Static Properties

LicenseKey Sets the license key.

Public Static Methods

QuickSendOverloaded. Sends a mail message, in a single line of code.

Public Instance Constructors

Smtp Constructor Initializes a new instance of the Smtp class.

Public Instance Properties

Bcc Gets or sets EmailAddressCollection object specifying BCC: recipients of the message.
BodyHtmlText Gets or sets HTML version of the message body.
BodyPlainText Gets or sets plain-text version of the message body.
Cc Gets or sets EmailAddressCollection object specifying CC: recipients of the message.
Charset Gets or sets charset of the message.
Conversion8BitTo7bit Gets or sets if (and how) the component should perform 8bit-to-7bit conversion of the message data if the given SMTP server does not support transmission of 8bit data but the message does contain such data.
DeliveryNotification Provides access to properties which control when and how ESMTP Delivery Status Notification messages will be sent to the message sender.
DirectSendDefaults Provides access to the default SMTP server settings to be used when connecting to SMTP servers discovered by MailBee via DNS MX lookup.
DnsServers Gets the DnsServerCollection object containing the list of DNS servers to be used for DNS MX lookup.
From Gets or sets EmailAddress object specifying the message sender.
IsAborted Indicates whether Abort method has been called for the component.
IsBusy Indicates whether the component is performing a lengthy operation.
IsConnected Indicates whether the component is connected to the server.
IsLoggedIn Indicates whether the component has already successfully authenticated on the server and logged in the user account.
IsSmtpContext Indicates whether the component is currently operating in a single thread mode, and the current connection (if any) is an SMTP connection.
IsSslConnection Indicates whether the current connection (if any) if secured with TLS/SSL layer.
JobsFailed Gets the list of e-mail tasks failed during processing.
JobsPending Gets the list of send-mail (sending a single message or mail-merge) tasks ready for processing.
JobsRunning Gets the list of e-mail tasks being processed right now.
JobsSuccessful Gets the list of successfully processed e-mail tasks.
JobsSyncRoot Gets the object to be used for synchronized access to the jobs collections.
LastResult Gets a numeric code of the last error.
Log Gets the object used for logging MailBee activities into a file or memory buffer.
MaxThreadCount Gets or sets the maximum number of threads MailBee may create during send mail operations.
Message Gets or sets the mail message which will be sent by the component on Send method call.
RaiseEvents Gets or sets whether the component will raise any events.
RaiseEventsViaMessageLoop Gets or sets whether the events will be raised on the message loop of the application or not.
ReplyTo Gets or sets EmailAddressCollection object specifying e-mail addresses to which the replies to this message should be sent.
RequestEncoding Gets or sets the encoding used to convert a string into a bytes stream which is then sent to the server.
ResponseEncoding Gets or sets the encoding used to convert a byte data received from the server into a string.
Site Gets or sets the object to be used as a site for the component.
SmtpServers Gets the SmtpServerCollection object containing the list of SMTP relay servers to be used for sending mail.
StopJobsOnError Gets or sets if processing of the jobs must be stopped if an error occurs.
Subject Gets or sets the subject of the message.
SynchronizingObject Gets or sets the object used to marshal the calls of the event handlers.
ThrowExceptions Gets or sets whether the component will throw exceptions on errors.
To Gets or sets EmailAddressCollection object specifying To: recipients of the message.
TrialDaysLeft Gets the number of days left to the date of the trial license key expiration.
Version Gets the version of the MailBee assembly.

Public Instance Methods

Abort Forces MailBee to cancel all pending operations and close all opened connections as soon as possible.
AddAttachment Reads the specified file from disk and adds it as attachment to the message.
AddJobOverloaded. Puts an e-mail message or a mail merge job onto waiting list for subsequent processing in bulk mode.
AuthPopBeforeSmtp Authenticates the user on a mail server using POP-before-SMTP authentication.
BeginAuthPopBeforeSmtp Begins an asynchronous request for a POP-before-SMTP authentication on a mail server.
BeginConnect Begins an asynchronous request for a connecting to an SMTP server.
BeginDisconnect Begins an asynchronous request for a disconnection from the server.
BeginExecuteCustomCommand Begins an asynchronous request for sending the specified user-defined command to the server and getting the response.
BeginHello Begins an asynchronous request for sending initial greeting to the SMTP server.
BeginLogin Begins an asynchronous request for authenticating the user on the SMTP server.
BeginRelayFromEmlFile Begins an asynchronous request for relaying a mail message to recipients.
BeginSend Begins an asynchronous request for sending a mail message to recipients.
BeginSendJobs Begins an asynchronous request to process the pending jobs and send out the resulting e-mails.
BeginStartTls Begins an asynchronous request to start TLS/SSL negotiation with the server.
Connect Connects to an SMTP server.
Disconnect Disconnects from the SMTP server and releases any used resources.
DisposeOverloaded. Closes opened network connections (if any) and releases any used system resources.
EndAuthPopBeforeSmtp Ends the pending asynchronous request for POP-before-SMTP authentication on a mail server.
EndConnect Ends the pending asynchronous request for connecting to the SMTP server.
EndDisconnect Ends a pending asynchronous disconnection request.
EndExecuteCustomCommand Ends the pending asynchronous request for sending user-defined command to the server.
EndHello Ends the pending asynchronous request for sending a greeting to the SMTP server.
EndLogin Ends the pending asynchronous request for authenticating the user on the SMTP server.
EndRelayFromEmlFile Ends the pending asynchronous request for relaying the message to the recipients.
EndSend Ends the pending asynchronous request for sending the message to the recipients.
EndSendJobs Ends the pending asynchronous request for processing the pending jobs and sending out the resulting e-mails.
EndStartTls Ends a pending asynchronous TLS/SSL negotiation request.
Equals (inherited from Object) Determines whether the specified Object is equal to the current Object.
ExecuteCustomCommand Sends user-defined command to the server and receives the server response to this command.
GetAcceptedRecipients Returns the list of the recipients accepted by the SMTP server.
GetCurrentSmtpServerIndex Returns SmtpServers collection's index of the server to which the component is connected or will connect on the next connection attempt.
GetErrorDescription Returns a textual description of the last error.
GetExtension Returns the name or parameters of the specified ESMTP capability.
GetExtensions Returns a reference to the key-value list of the server capabilities.
GetExtensionValue Returns the parameters of the specified ESMTP capability, or an empty string if the capability has no parameters.
GetHashCode (inherited from Object) Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures like a hash table.
GetMaxMessageSize Returns the maximum length of the message (in bytes) which is allowed by the SMTP server in order to accept the message from the client.
GetMXHosts Retrieves the list of hosts willing to accept mail for the given domain.
GetRefusedRecipients Returns the list of the recipients rejected by the SMTP server.
GetServerResponse Returns the last response from the server.
GetServerResponseCode Returns an integer value containing the status code of the last SMTP operation.
GetSocket Returns the underlying Socket MailBee uses for the current SMTP connection.
GetSocketError Returns a Win32 error code of the last socket-related error.
GetSupportedAuthMethods Returns a set of flags indicating which authentication methods are supported by the server.
GetType (inherited from Object) Gets the Type of the current instance.
Hello Sends initial greeting to the SMTP server.
Login Authenticates the user on the SMTP server if ESMTP authentication is enabled.
Noop Sends a NOOP command to the server.
RelayFromEmlFileOverloaded. Relays (sends without any modifications) the mail message previously saved as an .EML file, to the specified recipients.
ResetMessage Resets all properties of Message object to defaults. Delivery Status Notification settings (DeliveryNotification object) are also reset.
ResetState Resets the internal state of the component.
RetryFailedJobs Puts all failed send-mail jobs back into the queue.
SendOverloaded. Sends the mail message to the recipients specified in the message.
SendJobs Sends out all e-mails in the pending jobs queue (including e-mails generated via mail merge).
SendMailMerge Creates a series of e-mails based on an e-mail message template and a data table and sends these e-mails out.
StartTls Requests the mail server to start TLS/SSL negotiation and protect the connection with security layer.
StopJobs Notifies MailBee to stop processing jobs, completing sending out of all messages currently being processed.
SubmitJobsToPickupFolder Saves all e-mails in the pending jobs queue (including e-mails generated via mail merge) as files in the pickup folder of MailBee Message Queue or IIS SMTP service.
SubmitToPickupFolderOverloaded. Saves the mail message as a file in the pickup folder of MailBee Message Queue or IIS SMTP service.
TestSend Tests sending a mail message to the recipients without actual submitting of the message data.
ToString (inherited from Object) Returns a String that represents the current Object.
WaitOverloaded. Waits until the currently running (if any) asynchronous method is finished.

Public Instance Events

Connected Occurs when the connection with the server is successfully established.
DataReceived Occurs when data is received from the network.
DataSent Occurs when data is sent to the network.
Disconnected Occurs when the connection with the server gets closed.
Disposed Occurs after the component was disposed.
ErrorOccurred Occurs when the MailBeeException is thrown.
HostResolved Occurs when the SMTP server name is successully resolved into IP address(es).
LoggedIn Occurs when the component successfully authenticates the user on the SMTP server and logs in the user account.
LogNewEntry Occurs when an entry is written into the log file (or into the memory buffer if Smtp.Log.MemoryLog is true).
LowLevelDataReceived Occurs when data is received from the connected socket.
LowLevelDataSent Occurs when data is sent to the connected socket.
MergingMessage Occurs when the component is about to merge the e-mail template with a single data table row.
MessageDataChunkSent Occurs on progress of sending message source data to the SMTP server.
MessageDirectSendDone Occurs in direct send mode when the component finished submitting the mail message to all SMTP MX servers of recipients domains.
MessageMXLookupDone Occurs in direct send mode after the component finished DNS MX lookup of SMTP MX servers of recipients domains.
MessageNotSent Occurs when the message was not sent due to an error.
MessageRecipientSubmitted Occurs each time the next recipient in the mail message recipients list is accepted or refused by the SMTP server.
MessageSenderSubmitted Occurs after the sender of the mail message was successfully submitted to the SMTP server.
MessageSent Occurs after the message was successfully sent.
MessageSubmittedToPickupFolder Occurs after the current message was saved to MailBee Message Queue or IIS SMTP pickup folder.
MessageSubmittedToServer Occurs each time the message is successfully submitted to the SMTP server.
SendingMessage Occurs when the message is about to be sent.
SocketConnected Occurs when the SMTP server accepts the connection attempt and opens the transmission channel between the remote host (SMTP server) and the client (MailBee).
SubmittingMessageToPickupFolder Occurs when the message is about to be saved into MailBee Message Queue or IIS SMTP pickup folder.
TlsStarted Occurs when the connection with the server becomes secure.

Protected Instance Methods

DisposeOverloaded. When overridden in a derived class, must release unmananged and optionally managed resources used by the component.
Finalize (inherited from Object) Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection.
MemberwiseClone (inherited from Object) Creates a shallow copy of the current Object.

Protected Internal Instance Methods

OnConnected Used by MailBee to raise Connected event.
OnDataReceived Used by MailBee to raise DataReceived event.
OnDataSent Used by MailBee to raise DataSent event.
OnDisconnected Used by MailBee to raise Disconnected event.
OnErrorOccurred Used by MailBee to raise ErrorOccurred event.
OnHostResolved Used by MailBee to raise HostResolved event.
OnLoggedIn Used by MailBee to raise LoggedIn event.
OnLogNewEntry Used by MailBee to raise LogNewEntry event.
OnLowLevelDataReceived Used by MailBee to raise LowLevelDataReceived event.
OnLowLevelDataSent Used by MailBee to raise LowLevelDataSent event.
OnMergingMessage Used by MailBee to raise MergingMessage event.
OnMessageDataChunkSent Used by MailBee to raise MessageDataChunkSent event.
OnMessageDirectSendDone Used by MailBee to raise MessageDirectSendDone event.
OnMessageMXLookupDone Used by MailBee to raise MessageMXLookupDone event.
OnMessageNotSent Used by MailBee to raise MessageNotSent event.
OnMessageRecipientSubmitted Used by MailBee to raise MessageRecipientSubmitted event.
OnMessageSenderSubmitted Used by MailBee to raise MessageSenderSubmitted event.
OnMessageSent Used by MailBee to raise MessageSent event.
OnMessageSubmittedToPickupFolder Used by MailBee to raise MessageSubmittedToPickupFolder event.
OnMessageSubmittedToServer Used by MailBee to raise MessageSubmittedToServer event.
OnSendingMessage Used by MailBee to raise SendingMessage event.
OnSocketConnected Used by MailBee to raise SocketConnected event.
OnSubmittingMessageToPickupFolder Used by MailBee to raise SubmittingMessageToPickupFolder event.
OnTlsStarted Used by MailBee to raise TlsStarted event.

See Also

Smtp Class | MailBee.SmtpMail Namespace