MACROMEDIA COLDFUSION MX 61-CFML, Reference

Page: 178 / 806

178 Chapter 2: ColdFusion Tags
The following attribute is used with the PUT method to determine how to send data specified
with
httpparam type="formField"
:
The following attributes tell ColdFusion to put the HTTP response body in a file. You can put
the response body in a file for GET, POST, PUT, DELETE, OPTIONS, and TRACE methods,
but it is generally not useful with DELETE or OPTIONS.
Attribute Req/Opt Default Description
multipart Optional No
(Sends as
multipart
only if
request
includes File
type data.) Tells ColdFusion to send all data specified by
cfhttpparam
type="formField"
tags as multipart form data, with a
Content-Type of multipart/form-data. By default,
ColdFusion sends cfhttp requests that contain only
formField data with a Content Type of
application/x-www-form-urlencoded. (If the request also
includes File type data, ColdFusion uses the
multipart/form-data content type for all parts.)
If Yes, ColdFusion also sends the request’s charset in each
Content-Type description. All form field data must be
encoded in this character encoding, and ColdFusion does
not URLEncode the data. (The field name must be in
ISO-88591-1 or ASCII.) Some http parsers, including the
one used by previous versions of ColdFusion, ignore the
multipart form field character encoding description.
Attribute Req/Opt Default Description
path Required
if
file
is
specified.
Tells ColdFusion to save the HTTP response body in a file.
Contains the absolute path to the directory in which to store
the file.
file Required
if
path
is
specified
and not a
GET
method
See
Description Name of file in which to store the response body.
For a GET operation, defaults to the file requested in the
URL, if there is one. For example, if the URL in a GET
method is http:www.myco.com/test.htm, the default file is
test.htm. Do not specify the path to the directory in this
attribute, use the
path attribute.