A guide to all of the properties that ASPMail provides on our NT Servers.

BodyText

The message body text. To clear the text once you have set it use the ClearBodyText Method.

Example:

Mailer.BodyText = "Your order for 15 widgets has been processed"

Back to top

CharSet

The character set. By default the char set is US Ascii

Valid values:

  • 1 = US Ascii
  • 2 = ISO-8859-1

Example:

Mailer.CharSet = 2

Back to top

ConfirmRead

The ConfirmReading flag. If this is set to true AND the recipients e-mail program supports

this feature (and it is enabled) the recipients e-mail program will send a notice back to the FromAddress confirming that this e-mail has been read.

Example:

Mailer.ConfirmRead = true

Back to top

ContentType

The ContentType property allows you to set the ContentType header of the message's BodyText. If, for example, you wanted to send HTML as the messages's body, you could set ContentType = "text/html" and e-mail programs that support HTML content could properly display the HTML text.

Note: The ContentType property is ignored if you have file attachments.

Example:

Mailer.ContentType = "text/html"

Back to top

CustomCharSet

If you wish to use a character set besides the included types you can set CustomCharSet to a character set string.

Example:

Mailer.CustomCharSet = "ISO-2022" or
Mailer.CustomCharSet = "big5"

Back to top

DateTime

AspMail will, by default, create a Date/Time header for your local system using GMT. If you would like to override the date/time calculation set the DateTime property to a valid date/time string in the format defined by RFC 822 & RFC 1123. Example:

Mailer.DateTime = "Fri, 02 May 1997 10:53:49 -0500"

Back to top

Encoding

The encoding type for attachments. The default setting is MIME.

Valid values:

  • 1 = UUEncoded
  • 2 = MIME

Example:

Mailer.Encoding = 1

Back to top

FromName

The message originator's name.

Example:

Mailer.FromName = "Joe's Widget Shop"

Back to top

FromAddress

Tthe message originator's e-mail address.

Example:

Mailer.FromAddress = "joe@widgets.com"

Back to top

Organization

Sets the Organization header in the message.

Example:

Mailer.Organization = "Your Company Name"

Back to top

Priority

Sets the message priority. Priorities are 1-5 and are reflected in the X-Priority

Valid values:

  • 1 - High
  • 3 - Normal
  • 5 - Low

Example:

Mailer.Priority = 1

Back to top

RemoteHost

The remote SMTP host that the message will be sent through. This is typically an SMTP server located at your local ISP or it could be an internal SMTP server on your companies premises. Up to 3 server addresses can be specified, seperated by a semicolon. If the primary server is down the component will attempt to send the mail using the seconary server and so on.

Example:

Mailer.RemoteHost = "mail-out.rapidsite.net"
    or
Mailer.RemoteHost = "mail-out.rapidsite.net; mailhost.myotherisp.net"

Back to top

ReplyTo

The ReplyTo property allows you to specify a different e-mail address that replies should be sent to. By default mail programs should use the Reply-To: header for responses if this header is specified.

Back to top

Response

The Response property returns any error messages that may occur.

Back to top

ReturnReceipt

The ReturnReceipt flag. If this is set to true AND the recipients SMTP server supports this feature (and it is enabled) the recipients SMTP server will send a notice back to the FromAddress confirming that this e-mail has been delivered.

Example:

Mailer.ReturnReceipt = false

Back to top

SMTPLog

If you need to debug the session give a log file name here. Make sure the IUSR_XYZ IIS user has security that allows the component to write to this file. Warning: Do not use this setting in situations where multiple users can access this component at the same time. This is for single user debugging ONLY!

Example:

Mailer.SMTPLog = "c:\smtplog.txt"

Back to top

Subject

The message subject.

Example:

Mailer.Subject = "Stock split announced!"

Back to top

SuppressMsgBody

The SuppressMsgBody property is true by default and is used in conjuction with the SMTPLog property. When SMTPLog is set to a file and SuppressMsgBody is true the log file receives a copy of the message text. If SuppressMsgBody is false the message text is not sent to the log.

Back to top

TimeOut

Timeout is the maximum time that AspMail should wait for a response from the remote server. The default is 30 seconds.

Example:

Mailer.Timeout = 15

Back to top

Urgent

The urgent flag sets the X-Urgent header in the outgoing message. Not all mail readers support this flag.

Example:

Mailer.Urgent = true

Back to top

UseMSMailHeaders

MS-Mail priority headers, by default, are sent in addition to the standard SMTP priority headers. You can turn MS-Mail headers off with this property

Example:

Mailer.UseMSMailHeaders = false

Back to top

Version

Gets the internal component version number.

Example:

Response.Write "Component Version: " & Mailer.Version

Back to top

WordWrap

The WordWrap property is off by default. Setting WordWrap to true causes the message body to wordwrap at the position specified by the WordWrapLen property.

Back to top

WordWrapLen

The WordWrapLen property is set to 70 by default. You can modify the position that wordwrap occurs by changing this value.

Back to top

Please note: the information on this page applies to ITS web hosting plans. It may or may not apply to other environments. If you are looking for a feature described here, or better support from your hosting provider, please consider hosting your site with ITS!

1555 N Naperville/Wheaton Road, Suite 107
Naperville, IL 60563
phone 630.420.2550
fax 630.420.2771