|
Summary
Select event or file based transfer.
Description
The TransferMode property determines if a file transfer occurs directly between the specified remote file and a local disk file or if events will be generated which will allow the application
to transfer data to and from storage other than the local disk, such as through DDE or the clipboard. The value of this property can be set to either one of the following two constants.
| Value |
Meaning |
| TRANSFER_MODE_FILE |
Direct transfer between local and remote files. |
| TRANSFER_MODE_EVENT |
Event based transfer to and from remote files. |
When the TransferMode property is set to TRANSFER_MODE_FILE, then the FTP Client ActiveX control takes care of all input and output (I/O) operations required to get a file from the server or to put a
file onto the server. All the application needs to do is to set the LocalFile and RemoteFile properties so that they uniquely identify one local and one remote file before starting the file transfer.
Once the FILE_ACTION_GET or FILE_ACTION_PUT value is assigned to the FileAction property, then the ActiveX control completes the file transfer without generating any events or involving the
application in any other way.
When the TransferMode property is set to TRANSFER_MODE_EVENT, then a file is transferred through events. This means that one or more OnSend events (in case of a put or append operation) or one or
more OnReceive events (in case of a get operation) will be fired. An OnSend event asks the application to provide up to a maximum number of bytes of data, which are to be saved in the remote file.
OnSend events are generated until the application indicates that there is no more data to send. An OnReceive event delivers a portion of the data from the remote file to the application. Event based
file transfer allows an application to move data to and from storage other than the local disk, such as through DDE or the clipboard. For event based file transfer, the LocalFile property is ignored
and can be left blank.
The FileMode and EventMode methods can also be used to set the transfer mode. Please check the reference pages of these methods for more detailed information on their usage.
This property can be changed at any time except during a file transfer. The default value for this property is TRANSFER_MODE_FILE.
Example
FTPClient.RemoteFile = "test.exe"
FTPClient.LocalFile = "c:\test.exe"
FTPClient.TransferMode = TRANSFER_MODE_FILE
FTPClient.TransferType =
TRANSFER_TYPE_BINARY
FTPClient.FileAction = FILE_ACTION_GET
Note
For new applications use the EventMode or FileMode methods to set the file transfer mode.
| 
