POSTData property
|
WinHTTP component.
|
property POSTData: String;
|
The POSTData property specifies any optional data to send with the HTTP request. The optional data can be the resource or information being posted to the server.
|
|
The POSTData property is generally used to POST some data to the CGI programs. For example, you would like to emulate submission of some online form. Set the POSTData accordingly to the fields of HTML form. The format is following:
|
FieldName1=Value1&FieldName2=Value2&VieldNameN=ValueN
|
(Separate entries with "&" character.) Then just point the URL property to the CGI script (specified as <form action=URL> tag in HTML format) and call Read method to submit the form.
|
procedure TForm1.ReadBtnClick(Sender: TObject);
|
begin
|
WinHTTP1.URL := 'http://www.torry.net/quicksearch.php';
|
WinHTTP1.POSTData := 'String=HTTP&Exact=Yes&Title=No';
|
WinHTTP1.Read;
|
end;
|
|
procedure TForm1.WinHTTP1Done(Sender: TObject; ContentType: string; FileSize: Integer; Stream: TStream);
|
begin
|
// Receiving content from Stream
|
end;
|
1. | When you trying to POST data to the CGI program specifying the POSTData property, make sure that RequestMethod has set to rmAutoDetect or rmPOST;
|
2. | The WinHTTP component unable to post data to the CGI program when user working offline (even if user connected to the Internet). In this case, when you call the Read method, the OnHostUnreachable event occurs. Posting to the CGI programs requires active Internet connection.
|
RequestMethod property and Read method.
|