MACROMEDIA COLDFUSION MX 61-CFML Reference page 184

Attributes
Attribute Req/Opt
type Required
name Required.
Optional for
Body and XML
types
value Required
Optional (and
ignored) for File
type
file Required only if
type="File"
encoded Optional
mimeType Optional
Usage
Specifies header or body data to send in the HTTP request. The
information that the parameter specifies. A
subject to the following limitations:
•
An
XML type
or
formField type
184 Chapter 2: ColdFusion Tags
Default
Yes
attribute cannot be used with additional
attributes.
Description
Information type:
• Header: The parameter specifies an HTTP header.
ColdFusion does not URL encode the header.
• CGI: Specifies an HTTP header. ColdFusion URL
encodes the header by default.
• Body: Specifies the body of the HTTP request.
ColdFusion does not URL encode the body contents.
• XML: Identifies the request as having a content-type of
text/xml. Specifies that the value attribute contains the
body of the HTTP request. Used to send XML to the
destination URL. ColdFusion does not URL encode the
XML data.
• File: Tells ColdFusion to send the contents of the
specified file. ColdFusion does not URL encode the file
contents
• URL: Specifies a URL query string name-value pair to
append to the
cfhttp url
encodes the query string.
• FormField: Specifies a form field to send. ColdFusion
URL encodes the Form field by default.
• Cookie: Specifies a cookie to send as an HTTP
header. ColdFusion URL encodes the cookie.
Variable name for data that is passed. Ignored for Body
and XML types. For File type, specifies the filename to
send in the request.
Value of the data that is sent. Ignored for File type. The
value must contain string data or data that ColdFusion can
convert to a string for all
types can have string or binary values.
Applies to File type; ignored for all other types. The
absolute path to the file that is sent in the request body.
Applies to FormField and CGI types; ignored for all other
types. Specifies whether to URLEncode the form field or
header.
Applies to File type; invalid for all other types. Specifies the
MIME media type of the file contents. The content type
can include an identifier for the character encoding of the
file; for example, text/html; charset=ISO-8859-1 indicates
that the file is HTML text in the ISO Latin-1 character
encoding.
tag can have multiple
cfhttp
XML type
attribute. ColdFusion URL
attributes except
type Body
attribute identifies the
type
cfhttpparam
attributes, or with
body
. Body
tags,
, ,
file