Smtp.NET Documentation

Change History

Date - Release Description
October 8, 2004 - Version 3.0.5
  • Bug Fix: Fixed duplication of email addresses when NOT using mail merge, but utilizing database functionality.
August 20, 2004 - Version 3.0.4
  • Bug Fix: Removed extra space from the "RCPT TO:" SMTP command which caused some junk mail filters to flag emails from Smtp.NET as potential SPAM.
  • Bug Fix: When the ReturnCode FAILURE_CONNECT is returned, the LastError property is correctly set to "Operation Timed Out" instead of "-------------------" which was the result of the capture of an exception.
March 29, 2004 - Version 3.0.3
  • Bug Fix: Multiple CC addresses causes error with Postfix due to header formatting.
  • Bug Fix: The code view for the example DBImport.aspx was incorrect.
  • Bug Fix: AddAttachment now checks for the existence of the file being attached and will return true, if the file exists, or false if it does not exist - as noted in the documenation. 
  • Bug Fix: CC and BCC addresses dropped after first message only when using MailMerge and AddRecipient.
January 21, 2004 - Version 3.0.2
  • Change: Now allowing messages with no TO recipients. This will allow the addressing of messages to be all CC, BCC, or a combination of the two.
  • Change: Changed exception logging to detail the base/inner exception thrown
  • Change: Increased the connection timeout default from 5000 (5 seconds) to 30000 (30 seconds). This is due to an increased number of people reporting that they are unable to connect to thier mail server. Upon investigation, the connection to the mail server is timing out before the mail server has time to respond to a connection request.
  • Bug Fix: If a timeout is reported, the correct ReturnCode is now returned FAILURE_TIMEOUT. In some instances, the incorrect failure ReturnCode was being returned. This fix ensures that if a timeout occurs, it can be reliably programmed to check for this type of failure.
  • Bug Fix: The error message "Unable to open the registry emailQEngine for 'emailQEngine'" if registry settings for emailQ.NET are not present.
October 13, 2003 - Version 3.0.1
  • Change: Multipart-Mime message structure change for HTML emails with embedded images.
  • Fixed Bug: Fixed bug introduced which prevents eml files from being produced when using queuing features.
  • Fixed Bug: Corrected timing issue when connecting to some SMTP email servers, where connection would fail because a response was expected immediately where a delay is needed.
  • Fixed Bug: Fixed line wrapping problem with plain text message parts.
September 1, 2003 - Version 3.0
  • Enhancement: Easily zip compress attachments.
July 3, 2003 - Version 2.0.5a
  • Fixed Bug: Corrected bug introduced that names attachments "". This has been corrected.
July 1, 2003 - Version 2.0.5
  • Enhancement: Added better support for multi-part emails to increase compatibility of HTML based email messages with embedded images for a wide range of email clients: Outlook, Outlook Express, Eudora, AOL, Netscape, and Hotmail.
April 8, 2003 - Version 2.0.4
  • Fixed Bug: Fixed bug that occurs when specifying database parameters and calling the Send method - recipient email addresses are repeated.
March 3, 2003 - Version 2.0.3
  • Fixed Bug: Fixed bug when using the queuing features, where the good/bad counts were always set to zero and FAILURE_NEEDS_TO_EMAIL_ADDRESS is returned. This has been fixed.
  • Fixed Bug: Correct date/time in mail message header to show a "+" sign for the number of hours of departure, when appropriate, from GMT time, e.g. "+0500"
  • Fixed Bug: During mail merge, if an invalid email address is rejected by the mail server, Smtp.NET and the mail server go out of sync and the remaining email addresses do not receive the email.
  • Fixed Bug: Correct issue with custom header.
Feb 15, 2003 - Version 2.0.2
  • Fixed Bug: Fixed an encoding problem with html message body.  If the last character to be wrapped for the quoted-printable encoding type is an equal sign '=', the line was not wrapped properly.  This will most problems where the html message body does not format properly in some cases.
Jan 14, 2003 - Version 2.0.1
  • Enhancement: Mail Merge now supports dynamic attachments. Just like any other field that can be replaced with mail merge, you can now do a replacement on attachment names.
  • Fixed Bug: Using the BodyURL property, encoding of the html would, in a rare circumstance, cause images to not be displayed.
  • Fixed Bug: Html email with embedded images: if the <img> tag contained a src with a leading forward slash, "/", the image would not be properly embedded.  Fixed.
Dec 10, 2002 -
Version 2.0
  • Features Added: Added ability to send email messages to emailQ.NET - companion product to Smtp.NET

    New Properties Added:
    • PickupDirectory - Specifies the IIS/Exchange Pickup directory to drop queued email messages into.
    • QueueDirectory -Specifies the queue directory. The default is c:\temp\emailQ.NET.
    • QueueDateTime - Specifies the date and time that messages queued for delivery using should be sent. 
    • QueueFilenames -A StringCollection object containing the fully qualified pathname(s) of the files crated for the queue.
    • RandomObject - An object of class Random that is used to ensure uniqueness with Smtp.NET and emailQ.NET queuing. Specifically important if using Smtp.NET in a multithreaded environment.
    • SendToPickupDirectory -Specifies whether to create a "eml" file that is recognized by IIS/Exchange Smtp Server.
    • SendToQueue - Specifies whether to send messages to emailQ.NET.
  • Added Property: Charset -Specifies the charset to use for the message body and alternate body.
  • Added Property: ContentTransferEncoding -Specifies the content-transfer-encoding to use for the message body.
  • Added Property: ConnectionRetryDelay - Specifies the number of milliseconds to wait between retries of failed connections to the mail server
  • Added Property: SendDelay - Specifies the amount of time in milliseconds to wait before sending the next email message.
  • Added Event: ProgressEvent - raised in the Send and MailMerge methods.
Dec 9, 2002 -
Version 1.1.3.x
  • Fixed bug: leading periods were being double encoded.  Corrected
  • Fixed bug: Embedded images not being attached after first message in mail merge
Nov 10, 2002 -
Version 1.1.2.x
  • Fixed bug: If no recipients are specified while using MailMerge, a successful ReturnCodes is returned. Corrected so that FAILURE_NEEDS_TO_EMAIL_ADDRESS is returned.
  • Fixed bug: If connection to mail server fails, Smtp.NET will wait 30 seconds before trying to connect again. The delay should actually be only 3 seconds.
  • Fixed bug: If using Smtp.NET in a multithreaded environment, and/or logging to a file on disk, Smtp.NET would throw an exception trying to create the log file.  This has been corrected.
Oct. 28, 2002 -
Version 1.1.1.x
  • Added Feature: Previously, all html based message parts were encoded using "7Bit" and the "us-ascii" charset.  Smtp.NET now uses "quoted-printable" encoding for html message parts.  Also, the default charset is "iso-8859-1".  This allows users from countries outside of the US to send messages with unicode character sets.
  • Code Breaking Changes
    • Methods that previously returned integers are now returning a ReturnCodes type.  This is to remove the need for casting when checking a return code (integer) against a return code, e.g. if (Send() == (int)ReturnCodes.SUCCESS).  The easiest way to change your code to accomodate this change is to do a global search and replace for any casting to (int) and remove those instances.  We apologize if this causes a great inconvenience, however we feel that it is a better approach to take.
    • The SmtpDotNet.Definitions namespace has been dropped.  All enumerated types that were contained in this namespace have been relocated to the SmtpDotNet namespace.  Simply remove the using/import statement to SmtpDotNet.Defintions from your code.
  • Fixed bug with mixed HTML and PLAIN text messages which affected some mail reader programs.  The plain text message would be displayed instead of the HTML message.
  • Fixed bugs with Mail Merge:
    • Not personalizing the AltBody
    • Not clearing attachments with each subsequent send.
    • Not personalizing the Subject
    • When in debug mode, the message header is not logged.
  • Fixed bug with EmailReport: DataSet did not contain all of the good and bad email addresses.
  • Fixed bug with leading "." (period), getting stripped out when viewed in some email reader programs, i.e. Outlook
  • Fixed bug with CharsPerLine - Lines were not properly broken at the set number when message included attachment or another MIME part.
  • Fixed bug where appending to the log file was not working properly.
  • Fixed bug with calling the Send method multiple times would not clear the previous sends' MIME attachments.
  • Changed preamble so that it does not display the AltBody, which was used to support older mail readers, instead it displays the short message: "This is a multi-part message in MIME format. Since your mail reader does not understand this format, some or all of this message may not be legible."  This is to ensure that the message size is not larger than needed.
Aug. 21, 2002 -
Version 1.1.963.38933
  • Added new method: SendQuick - a static method for quickly sending an email message
  • Added new property: ErrorReport - A DataSet that contains two tables: "good" and "bad", that respectively contain email address that had the message sent to, and email addresses that were not.
  • Fixed bug with MailMerge when TestMode is set to true, the message is sent when it shoud not be.
  • Fixed bug where html emails with an alternate body would display the text message in some circumstances.
  • Minor corrections to documentation and examples.
  • Added VB documentation and examples.
  • Fixed bug with sending a message with no message body and an attachment.  Some mail reader programs would not recognize the attachment.
July 12, 2002 - Version 1.0.923.38427
  • Corrected sequencing of connection to mail server that caused random problems with connection and disconnection. This fix directly affects ArGoSoft Mail Server Freeware but may affect other mail servers as well.
  • The Smtp.NET assembly is now added to the GAC by default during installation.
  • The property "LogSmtpMessages" has been renamed "LogMailServerMessages" to better reflect its purpose.
May 14, 2002 - Version 1.0 Released

Initial Release