image\cslogo3d1.gif

Chili!Mail (SMTP) Component

The Chili!Mail component enables users to send e-mail messages from an ASP page to an SMTP e-mail server. The Chili!Mail component is compatible with the NewMail object included with the Microsoft Internet Information Services (IIS) CDONTS component. However, the Chili!Mail component does not support the following properties and methods of the NewMail object:

·   ContentBase

·   ContentLocation

·   MailFormat

·   Version

·   AttachURL

·   SetLocaleIDs

Other differences between the Microsoft NewMail object and the Chili!Mail component are described in the property and method descriptions that follow.

Chili!Mail Registry Settings

The Chili!Mail component does not use registry settings.

Chili!Mail Control Reference

The Chili!Mail component is registered with the ProgId of "CDONTS.NewMail."

The following ASP script written in VBScript creates an instance of the component:

Set mailer = Server.CreateObject("CDONTS.NewMail")

Chili!Mail Properties

The Chili!Mail component exposes the following properties:

·   To   

·   From   

·   Cc   

·   Body

·   BodyFormat

·   Subject   

·   Host   

·   Bcc   

·   Value

·   Importance  

·   Retain

·   WrapLength

Chili!Mail To Property (String: Read/Write)

The To property specifies one or more message recipients. A full messaging address must be provided for each recipient, as shown in the following example:

"useraddress@company.com"  

Addresses must be separated by a semicolon (;), as shown in the following example:

"user1@company1.com;user2@company2.com;user3@company3.com"  

If both the To property and the To parameter of the Send method are supplied, the message is sent to all recipients in both lists.

Chili!Mail From Property (String: Read/Write)

The From property is a string that specifies the content of the From field of the message header. It cannot include spaces.

Note

The From field cannot exceed 255 characters, the limit for a single e-mail address. There is no character limit for the To, Cc, and Bcc fields.

Chili!Mail Cc Property (String: Read/Write)

The Cc property specifies one or more recipients of a copy of the message. A full messaging address must be provided for each recipient, as shown in the following example:

"useraddress@company.com"  

Addresses must be separated by a semicolon (;), as shown in the following example:

"user1@company1.com;user2@company2.com;user3@company3.com"  

Chili!Mail Bcc Property (String: Read/Write)

The Bcc property specifies one or more recipients of a blind copy of the message. A full messaging address must be provided for each recipient, as shown in the following example:

"useraddress@company.com"

Addresses must be separated by a semicolon (;), as shown in the following example:

"user1@company1.com;user2@company2.com;user3@company3.com"  

Chili!Mail Subject Property (String: Read/Write)

The Subject property is a string that specifies the content of the subject line of the message. This property may be left empty.

Chili!Mail Body Property (String: Read/Write)

The Body property is string that specifies the content of the message. Line breaks should be sent as carriage-return/linefeed pairs, e.g., "Chr(13) & Chr(10)."

Chili!Mail BodyFormat Property (Long: Read/Write)

The BodyFormat property specifies the message format available for the Chili!Mail Body property. The values for the BodyFormat property can be set as follows:

·   0 indicates that the Body property can include HTML.

·   1 indicates that the Body property can include plain text only.

Chili!Mail Host Property (String: Read/Write)

The Host property is a string that specifies the valid DNS name (for example, "mail.myorg.com") or IP address of the SMTP mail server. The default is "localhost."

Chili!Mail Value Property (Read/Write)

The Value property adds one or more headers to the automatically generated headers, such as To, From, Subject, and Date. Possibilities for additional headers include File, Keywords, and Reference.

Certain headers, such as Reply-To, are widely accepted and used by various messaging systems. For such a header to be recognized by recipients, the character string in the header name must exactly match the accepted string.

In principle, you can put any combination of ASCII characters in the string, but some messaging systems might restrict the character set. The safest procedure is to limit the string to alphanumeric characters, dashes, and slashes, and in particular to avoid spaces.

You can set the Value property more than once. Each setting generates another header to be included with the existing headers.

Chili!Mail Importance Property (Long: Read/Write)

The Importance property specifies the importance of the message to be sent. Valid values are:

·   0 indicates low Importance

·   1 indicates normal importance

·   2 indicates high importance

Chili!Mail Retain Property (BOOLEAN: Read/Write)

The Retain property specifies whether or not message properties are retained after the Send method is called. If set to True, all of the properties are retained. If set to False (the default), all properties are cleared.

Chili!Mail WrapLength Property (Read/Write)

The WrapLength property applies to message content. It specifies the maximum number of characters allowed in a line before the line wraps; in other words, before it breaks and continues on the next line. The line breaks at the last space before the specified maximum number of characters has been reached. The default setting is 77. The maximum is 1,000.

Chili!Mail Methods

The Chili!Mail component provides the following methods:

·   AttachFile  

·   Send

Chili!Mail AttachFile Method

The AttachFile method attaches a file to the message. Messages are multi-part mime encoded, and attachments follow the text portion of the message.

Arguments:

Source

A string containing the absolute path name of the file to attach.

CDONTS Note

All messages are Base64 encoded. There is no provision for specifying a different encoding method.

Chili!Mail Send Method

The Send method sends the message using the properties previously set. All arguments to this method are optional and override the properties previously set for the message (except for the To argument, which is combined with any previously set To property).

Calling the Send method re-sets all message properties in preparation for the next message, unless the Retain property is set to True. Multiple messages can be sent using the same instance of the Chili!Mail component.

Arguments:

From

See the description of the property of the same name above.

To

See the description of the property of the same name above.

Subject

See the description of the property of the same name above.

Body

See the description of the property of the same name above.

Importance

See the description of the property of the same name above.

Host

See the description of the property of the same name above.

Example 1:

Set mailmsg = Server.CreateObject("CDONTS.NewMail")

mailmsg.To = "youraccount@yourco.com"

mailmsg.From = "MailTest"

mailmsg.Body = "This is a test message." & Chr(10) & "This is the second line."

mailmsg.Host = "mail.yourco.com" 

mailmsg.Send

Example 2:

Set mailmsg = Server.CreateObject("CDONTS.NewMail")

Message = "This is a test message." & Chr(10) & "This is the second line."

mailmsg.Send ("myaccount@yourco.com", "youraccount@yourco.com", "Test Subject", Message, 2, "mail.yourco.com")