Post Method

Posts data to the HTTP server using the HTTP POST method.

Syntax

int Post(const QString& qsURL);

Remarks

This method posts data to the HTTP server using the HTTP POST method. The posted data is taken from PostData and/or AttachedFile properties. The server response text is received through the Transfer event, and the HTTP response headers through the Header event. If LocalFile is not empty the data (not the headers) is written there as well.

If the goal is to upload a file or binary form data to a receiving script, the postdata must be MIME encoded, or you should use the WebUpload or WebForm component.

Example (Performing a Post)

HTTPControl.ContentType = "application/x-www-form-urlencoded"
HTTPControl.PostData = "firstname=Tom&lastname=Thompson&country=US"
HTTPControl.Post(myurl)

Error Handling

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)