Properties
| Username |
Definition |
Description |
|
Run-time : RW |
Username() As String |
A valid username for FTP authentication |
| TransferType |
|
|
|
Run-time : RW |
TransferType () As nb_TransferType |
Whether the ftp DLL uses ASCII or binary mode for file transfers |
| ShowDialog |
|
|
|
Run-time : RW |
ShowDialog() As Boolean |
When true the DLL displays the cancelable transfer dialog during file uploads and downloads. When false no dialog is displayed. Note – the transferprogess event is still raised by the DLL for every 255 bytes of data transferred if showDialog is false. |
| ProxyServer |
|
|
|
Run-time : RW |
ProxyServer() As String |
If a proxy server is used this is the name or IP of the proxy server. |
| proxyBypassList |
|
|
|
Run-time : RW |
proxyBypassList() As String |
Space delimited string servers that are to bypass the proxy server. Wildcards are acceptable in this list eg *inte* will bypass server painter and internal. |
| Password |
|
|
|
Run-time : RW |
Password() As String |
A valid password for FTP server authentication |
| Passive |
|
|
|
Run-time : RW |
Passive() As Boolean |
When true the DLL uses passive transfers to and from a FTP server. |
| LicName |
|
|
|
Run-time : RW |
LicName() As string |
Your Order ID obtained from the original website order. |
| LicKey |
|
|
|
Run-time : RW |
LicKey() As string |
Your licence Key.
|
| InitDir |
|
|
|
Run-time : RW |
InitDir() As string |
The initial directory connected to upon successful authentication on an FTP server. |
| Host |
|
|
|
Run-time : RW |
Host() As string |
The name or IP address of an FTP Server. |
| FTPPort |
|
|
|
Run-time : RW |
FTPPort() As long |
The port number used. The default value is port 21. |
| FTPPort |
|
|
|
Run-time : RW |
FTPPort() As long |
The port number used. The default value is port 21. |
| Directory |
|
|
|
Run-time : R |
Directory() As Directory |
A collection items, both files and folders in the current directory of the FTP Server |
| UseLocalMachineTime |
() as Boolean
|
|
Methods
| Connect |
Definition |
Description |
| |
Connect() as Boolean |
Connects to an FTP server. Returns true on a successful connection and false if the connection attempt was not successful. |
| CancelTransfer |
|
|
| |
CancelTransfer () as Boolean |
Cancels the current transfer Operation |
| CreateDirectory |
|
|
| |
CreateDirectory(sDirectory as string) as Boolean |
Creates a new directory in the current directory on an FTP server. Returns true on success or false on failure |
| DeleteFile |
|
|
| |
DeleteFile(sFilename as string) as Boolean |
Deletes a file from the current directory an FTP server. Returns true on a successful deletion and false if the delete attempt was not successful. |
| Disconnect |
|
|
| |
Disconnect() as Boolean |
Ends the connection to an FTP server. Returns true on a successful disconnection and false if the disconnection attempt was not successful. |
| GetCurrentDirectory |
|
|
| |
GetCurrentDirectory() as string |
Returns a string value containing the current FTP directory name. |
| GetDirectoryListing |
|
|
| |
GetDirectoryListing (sFilter as string) as boolean |
Refreshes the currently directory listing for the current directory. A filter string may be applied to the listing. Eg *.gif will only populate the list with files ending in ‘.gif'. *.* will list all folders and files in the directory.
The directory items may be accessed through the ftp DLL directory properties. Eg oftp.directory.items.count returns the number of files and folders in the directory matching the filter string.
Returns true on success or false on failure. |
| GetFileProgress |
|
|
| |
GetFileProgress (sLocal as string, sRemote as string) as boolean |
Gets a file from a FTP server. sLocal is a fully qualified pathname on the local computer and sRemote is the name of file in the current FTP server directory.
Returns true on success or false on failure.
The TransferProgress event is fired for every 255 bytes of data transferred. |
| GetRemoteFileSize |
|
|
| |
GetRemoteFileSize (sFilename as string) as long |
Returns the size in bytes of a file, specified by sFilename on a FTP server. |
| PutFileProgress |
|
|
| |
PutFileProgress (sRemote as string, sLocal as string) as boolean |
Puts a file to a FTP server. sLocal is a fully qualified pathname on the local computer and sRemote is the name of file in the current FTP server directory.
Returns true on success or false on failure.
The TransferProgress event is fired for every 255 bytes of data transferred. |
| RemoveDirectory |
|
|
| |
RemoveDirectory (sDirectoryname as string) as Boolean |
Removes a directory on a FTP server. Note – the resource specified by sDirectoryname must be a directory and must not contain any files or sub-directories.
Returns true on success or false on failure. |
| RenameFile |
|
|
| |
RenameFile (sExisting as string, sNewName as string) as Boolean |
Renames an existing file on a FTP server.
Returns true on success or false on failure. |
| SetCurrentDirectory |
|
|
| |
SetCurrentDirectory (sDir as string) as Boolean |
Changes the current directory on a FTP server. sDir is the name of directory in the current directory, use setcurrentdirectory(“..”) to go up one folder in the directory tree.
Returns true on success or false on failure. |
Events
| Cancelled |
|
|
| |
Cancelled() |
Raised when the user clicks the cancel button of the file transfer progress dialog |
| Connected |
|
|
| |
Connected() |
Raised on successful connection to a FTP server. |
| Disconnected |
|
|
| |
Disconnected () |
Raised on disconnection from a FTP server. |
| GetPutSuccess |
|
|
| |
GetPutSuccess () |
Raised on a successful file download or upload |
| TransferProgress |
|
|
| |
TransferProgress (lCurrentBytes as long, lTotalBytes as long) |
Raised every 255 bytes of data transferred during getFileFTP and putFileFTP. |
| FTPError |
|
|
| |
FTPError(ErrorNumber As Long, Description As String) |
FTP Error Handler |
| FTPEvent |
|
|
| |
FTPEvent (EventNumber As Long, Description As String) |
Generic Event Handler
|
Event Number |
Description |
|
1 |
connected to server |
|
2 |
Disconnected from server Failed |
|
100 |
Got Remote File Size |
|
101 |
File downloaded |
|
102 |
File uploaded |
|
103 |
remote file deleted |
|
1000 |
File Listing Completed |
|
1001 |
Got current remote directory name |
|
1002 |
set current remote directory |
|
1003 |
remote directory created |
|
1004 |
remote directory deleted | | Enumerations
| nb_TransferType |
Definition |
Description |
| |
Public Enum nb_TransferType
nb_ASCII= &h3
nb_Binary = &H0
nb_Unknown =&H0
End Enum |
Mode used for file transfers. Default is binary transfer | |



Click here to return to the Easy FTP page |