FTP Component

The FTP control can be used to transfer files to and from FTP servers using the FTP Protocol. (NOTE: The following is a very short description. For more information, please consult the help files that come with the respective package.)

The FTP control implements a standard FTP client as specified in RFC 959 and RFC 1579.

The first step in using the control is specifying the RemoteHost, User and Password. The file to upload to or download from is given by the RemoteFile property. The file to download to or upload from is specified by LocalFile. The current path in the server is specified by the RemotePath property. The Passive property is especially useful if the client is behind a firewall which inhibits incoming connections to higher ports.

The control operates by setting appropriate values to the Action property. If LocalFile is set to something other than an empty string, then files are received in LocalFile, otherwise the data is received through the Transfer event. StartTransfer and EndTransfer are fired at the beginning and end of transmission.

The PITrail event traces the interaction between the client and the server (the FTP Protocol Interface connection).

Directory listings are received through the DirList event.

This control requires a Winsock 1.1 compliant TCP/IP stack. This means that the Winsock stack installed in the system must have a version of at least 1.1. In particular, Windows 95, 98, and NT machines with Winsock 2.0 are fully supported.

PROPERTIES

Action. An action code for the control.

AltFile. The new name for RemoteFile when Action is set to Rename.

Command. Can be used to send additional commands directly to the FTP server.

LastReply. The last reply from the server.

LocalFile. The path to a local file for download/upload. If the file exists, it is overwritten.

LocalHost. The name of the local host. When connected, the IP address of the interface through which the connection was made.

Passive. Controls whether to direct the server into passive mode especially if behind a firewall.

Password. The password to login with.

RemoteFile. The name of the remote file for uploading/downloading.

RemoteHost. The domain name or IP address of the FTP server.

RemotePath. The current path in the FTP server.

RemotePort. The port for the FTP service (default is 21).

SocketHandle. The handle of the main socket used by the control.

StartByte. The byte index in RemoteFile and LocalFile where to start the transmission.

TransferMode. The transfer mode (ASCII or Binary). If the value is 0 (default), the initial server mode will be used.

User. The user id to login as.

WinsockInfo. Identifying information about the loaded Winsock stack.

WinsockLoaded. Loads and unloads Winsock on demand.

WinsockMaxDatagramSize. Size in bytes of the largest UDP datagram that can be sent or received.

WinsockMaxSockets. Maximum number of sockets available to a single process.

WinsockPath. The path to the Winsock DLL used.

WinsockStatus. The status of the Winsock stack.

EVENTS

DirList. Fired when a directory entry is received.

EndTransfer. Fired when a file completes downloading/uploading.

Error. Information about errors during data delivery.

PITrail. Traces the commands sent to the ftp server, and the respective replies.

StartTransfer. Fired when a file starts downloading/uploading.

Transfer. Fired during file download/upload.