MACROMEDIA COLDFUSION MX 61-CFML, Reference

Page: 246 / 806

246 Chapter 2: ColdFusion Tags
cfmailparam
Description
Attaches a file or adds a header to an e-mail message. Can only be used in the
cfmail
tag. You can
use more than one
cfmailparam
tag within a
cfmail
tag.
Category
Forms tags , Internet Protocol tags
Syntax
<cfmail
to = "recipient"
subject = "msg_subject"
from = "sender"
...more attributes... >
<cfmailparam
file = "file-name"
type ="media type">
or
<cfmailparam
name = "header-name"
value = "header-value" >
...
</cfmail>
See also
cfmail , cfmailpart , cfftp , cfhttp , cfldap , cfpop
History
ColdFusion MX 6.1: Added the
type
attribute.
Attributes
Example
<h3>cfmailparam Example</h3>
<p>This view-only example uses cfmailparam to attach files and add header to
a message.</p>
<cfmail from = "peter@domain.com" To = "paul@domain.com"
Subject = "See Important Attachments and Reply">
Attribute Req/Opt Default Description
file Required if you do not
specify
name
attribute
Attaches file to a message. Mutually exclusive with
name
attribute. The file is MIME encoded before sending.
type Optional The MIME media type of the part. Can be a valid MIME
media type or one of the following:
• text specifies text/plain type
• plain specifies text/plain type
•
html specifies text/html type
Note: For a list of all registered MIME media types,
see www.iana.org/assignments/media-types/
name Required if you do not
specify
file
attribute
Name of header. Case-insensitive. Mutually exclusive
with
file
attribute.
value Optional Value of the header.