Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

CURL.FormAddKeyContainer

Add a section to a multipart/formdata HTTP POST.

Component Version macOS Windows Linux Server iOS SDK
CURL 2.6 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "CURL.FormAddKeyContainer"; curl; Name; FileName; Container { ; ContentType; ContentHeaders } )   More

Parameters

Parameter Description Example Flags
curl The CURL session handle. $curl
Name The name of the form field. "city"
FileName The file name for this file. "test.txt"
Container The file content as a container value. Can be PDF, PNG, GIF, BMP, JPEG or other file content.
ContentType The content type for this file. "text/plain" Optional

Added in version 10.3.
ContentHeaders List of headers to include. "Content-Id: 12345" Optional

Added in version 10.3.

Result

Returns "OK" or error code.

Description

Add a section to a multipart/formdata HTTP POST.
This adds file form field with a given name and value.

Please call CURL.FormFinish after you added all your fields and before you call CURL.Perform.

Examples

Add file from container:

MBS("CURL.FormAddKeyContainer"; $curl; "Attachment"; "paris.jpg"; Test::test)

Add SOAP request with MTOM attachment:

Set Variable [ $result ; Value: MBS("CURL.FormAddKeyText"; $curl; "request"; "<soap:Envelope><soap:Body><tns:data><xop:include href=\"test.png\"/></tns:data></soap:Body> </soap:Envelope>"; "text/xml") ]
Set Variable [ $result ; Value: MBS("CURL.FormAddKeyContainer"; $curl; "test"; "image.png"; Table::ContainerField; "image/png"; "Content-Id: 1234") ]
Set Variable [ $result ; Value: MBS("CURL.FormFinish"; $curl) ]

See also

Release notes

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 14th May 2020


CURL.FileInfos - CURL.FormAddKeyContainerContentType