MultiPartFormEncoding (HttpRequest property)

<section begin=dpl_desc/><section end=dpl_desc/>

This property sets and returns a Boolean enumeration (True or False) that indicates whether Multipart Form encoding support is on or off. If on (True), an HTTPRequest object can send file data to a web site from either a Longstring or a Stringlist.

The Post of file data using this encoding support emulates an HTML form that uses enctype="multipart/form-data" and a type="file" input field.

Syntax

%curr = %httpreq:MultiPartFormEncoding %httpreq:MultiPartFormEncoding = newvalue

Syntax terms

%curr	The value (True or False) of %httpreq's MultiPartFormEncoding property.
%httpreq	A previously defined and instantiated HTTPRequest object.
newvalue	The Boolean enumeration value (True or False) to assign to %httpreq's MultiPartFormEncoding property.

Usage notes

• To enable file-based form uploads:
  1. Set MultiPartFormEncoding to True.
  2. Add form data to the HTTP request with the AddField method.
  3. Use the Post function to send the request.
• MultiPartFormEncoding must be set to True before any AddField statements are issued, or the request is cancelled.
• For an example of code that uses the MultiPartFormEncoding property, see this AddField example.
• For information about Enumerations, see "Enumerations".