|
Summary
Set transfer type to direct transfer.
Syntax
Boolean FileMode ()
Description
The FileMode method sets the file transfer mode to direct file transfer. This means that 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 or append a file onto the server. All the application needs to do is to set the LocalFile and RemoteFile properties or pass the local file and remote file names to
GetFile, PutFile, or AppendFile so that they uniquely identify one local and one remote file before starting the file transfer. Once the FILE_ACTION_GET, FILE_ACTION_PUT or FILE_ACTION_APPEND value
is assigned to the FileAction property or the GetFile, the PutFile or the AppendFile method is called, then the ActiveX control completes the file transfer without generating any events or involving
the application in any other way.
The FileMode method takes no parameters and returns a boolean. If the transfer mode can be successfully set to direct file transfer, then the method returns True; otherwise, it returns False. The
application should ensure that the method was successfully executed by checking the return value. The method also sets the LastResult property. The value of the LastResult property can be checked to
determine if any error occurred.
Calling this method is equivalent to setting the TransferMode property to TRANSFER_MODE_FILE.
This method can be called at any time except during a file transfer.
Note
Use this mode to transfer files and directories without any file I/O. Data recovery on failed transfer is not supported in this mode. For data recovery you must use an event based transfer.
Example
Result = FTPClient.FileMode ()
|