The PutData method transfers data from a local buffer and
submits to the server using the PUT command. If a String variable is
used for the buffer, the text will be automatically UTF-8 encoded
before it is submitted to the server. If you need to submit binary
data, you should always use a Byte array as the buffer rather
than a String. If you need to use something other than UTF-8
encoding, use the PutText method in combination with the
CodePage parameter to specify an alternate encoding.
Not all servers will accept data submitted using this method, and
some may require that specific configuration changes be made to the
server in order to support the PUT command. Consult your server's technical reference
documentation to see if it supports the PUT command, and if so, what
must be done to enable it. It may be required that the client
authenticate itself by setting the UserName and
Password properties prior to uploading the data.
If the Buffer parameter is a String type, this method
presumes that it only contains text and will automatically convert the
contents to UTF-8 encoded text. If the string contains binary data,
this encoding can corrupt the data. To prevent this conversion,
convert the string to a byte array using the StrConv function.
This method will cause the current thread to block until the file
transfer completes, a timeout occurs or the transfer is canceled.
During the transfer, the OnProgress event will fire
periodically, enabling the application to update any user interface
objects such as a progress bar.