NET FTP Library
FTP Class Properties


KellermanSoftware.NetFtpLibrary Namespace : FTP Class

For a list of all members of this type, see FTP members.

Public Properties
 NameDescription
Public Property Account Name to use for the lesser used ACCT command required by some FTP Servers This is different than the UserName and Password  
Public Property Account Password to use for the lesser used ACCT command required by some FTP Servers This is different than the UserName and Password  
Public Property By default the .NET FTP Library assumes your FTP Server supports the APPE command when connections are lost. If set to false, the entire file is re-transfered when the connection is lost  
Public Property If true there is an Asynchronous tranfer in progress  
Public Property Specify the Buffer Size for transfers in bytes. The default is 4096.  
Public Property  
Public Property If true, ensure the integrity of the transfer by issuing an XCRC. Your FTP Server must support XCRC. See the Features() method.  
Public Property Use a local X509 Client Certificate to encrypt an SSL FTP Session  
Public PropertySpecifies the current FTP directory.  
Public Property The name of the current directory being transferred (the source directory name). This property is filled durring asynchronous uploads/downloads for directories. For single file operations, this property is string.empty.  
Public Property When uploading/downloading directories this is the number of the current directory or subdirectory being transferred.  
Public Property The name of the current file being transferred. This property is filled during asynchronous uploads/downloads.  
Public Property The currently transferring file destination. This property is filled during asynchronous uploads/downloads.  
Public Property When uploading/downloading directories this is the number of the current file being transferred.  
Public Property Attach a custom logger for logging  
Public Property

Contains regular expression formats to parse the date and time portion of FTP directory listings. You may add your own date/time parsing format for your FTP server. Please put the parsing expressions into .NET regular expression groups. See the examples below.

Regular Expression Groups

  • month
  • day
  • year
  • hour
  • minute
  • m - am/pm designator
 
Public Property When EnableLogging() is used, performs verbose logging of SSL Certificates and Streams  
Public Property When uploading/downloading directories, this is the total number of directories and sub directories to be transferred.  
Public Property

Contains regular expression formats to parse FTP directory listings. By default if a directory entry cannot be parsed it is not put into the list. To see lines that cannot be parsed, turn on StrictDirectoryParsing. You may add your own parsing formats to the list. Please use these regular expression groups. See the examples below.

Regular Expression Groups

  • dir - Directory flag
  • permission - Permissions for the file or directory
  • size - The size of the file
  • timestamp - The date and time information (This is further parsed by the DateParseFormats)
  • name - The name of the file or directory
 
Public Property If true the FTP component connects via SSL using the AUTH TLS command. The remote FTP server must have an SSL certificate installed for the FTP server in order to use SSL.  
Public Property By default, any SSL Certificate errors are ignored. If EnsureCertificates is set to true, SSL Certificate errors will be thrown as exceptions  
Public Property During a file/directory transfer operation, this is the time that remains. This is calculated by the average KB/Second and the remaining bytes to transfer.  
Public Property Some FTP servers do not allow root access. Kellerman FTP automatically detects this but it can be overridden. Example: _ftp.Connect(); _ftp.CurrentDirectory="MyDirectory"; _ftp.ExactDirectoryMode=false;  
Public Property When uploading/downloading directories this is the total number of files to be transferred.  
Public Property Directory Separator Character. Default is '/'  
Public PropertySpecifies the host name or IP Address of the FTP Server.  
Public Property The difference in hours between the local time and the FTP Server Time. See the CalcHourDifference to automatically calculate the hour difference between the local PC and the FTP Server.  
Public Property By default, local directories that do not have permission to be read will throw an unauthorized exception. Setting this flag ignores those errors.  
Public Property Gets or sets the implicit SSL port. The default is 990  
Public Property The IP End Point of the remote server  
Public PropertyReturns true when any FTP operation is in progress.  
Public Property  
Public PropertyReturns true if we are connected to the FTP server.  
Public Property During a file or directory transfer operation, this is the average transfer rate in KB/Sec.  
Public Property During a file or directory transfer operation, this is the highest transfer rate in KB/Sec.  
Public PropertyThis is the current speed of a file or directory transfer in KB/Sec.  
Public Property This is the maximum number of KB/Sec of bandwidth that the FTP component will use If zero, it will transfer at top speed.  
Public Property When synchronizing, or when not overwriting files, this is the current number of bytes that didn't need to be transferred.  
Public Property Get the last exception that occurred during an FTP Operation. This value is automatically set to null each time a new FTP Session is Connected. The default for this property is null.  
Public PropertyReturn the last FTP Command Attempted.  
Public PropertyReturn the last FTP Response from the server.  
Public Property If true, the user name and password will be replaced with **** when logging, otherwise they will be displayed. The default is true.  
Public Property If a file already exists locally it will be overwritten during a download. The default for this property is false.  
Public Property If a local file is a read only file it will be overwritten durring a download. The default for this property is false.  
Public Property Pad a zero to the front of the local CRC if there is an odd number of digits. Some FTP Servers add a pad of zero to the front if there is an odd number of digits and some do not. The default is false.  
Public Property Returns the parent directory for the current directory or the root  
Public PropertySpecifies the password to use while communicating with the FTP Server.  
Public Property When connecting to SSL by default it tries to issue a PBSZ 0 before logging in. By setting to true it only tries PBSZ 0 after logging in. The default is false.  
Public Property The percent complete for the overall transfer  
Public PropertySpecifies the port to communicate with the FTP Server. The default is 21.  
Public Property Hold Information about the FTP Proxy Server. Socks 5 is normally used for proxy servers with port 1080. The older Socks 4 is supported, this also normally operates on port 1080.  
Public Property Gets/Sets the timeout in milliseconds when reading/writing to a local file stream or network stream. The default is to wait 30000 (30 seconds).  
Public Property When a connection is lost and we are attempting to reconnect. This command is sent to ensure the server is responding. This defaults to NOOP  
Public Property By default the .NET FTP Library assumes your FTP Server supports the REST command when connections are lost. If set to false, the file is attempted to be appended  
Public Property Retry timeout in milliseconds if a network connection drops. The default is to wait 5 minutes if the network drops and then retry an upload or download from the last byte position. If no retry is desired set to -1.  
Public Property Uniquely identifies this instantiated FTP object  
Public Property When synchronizing, or when not overwriting files, this is the current number of files that didn't need to be transferred.  
Public Property The SSL or TLS protocol (The default is SslProtocols.Default which is SSL 3.0 or TLS 1.0)  
Public Property When doing a GetDirectoryListing if a directory line cannot be parsed, throw an exception. The default is false.  
Public Property Determines which files are transferred during synchronization. Default is CopyIfTheSizeIsDifferentOrDateIsNewer  
Public Property During a file/directory transfer operation, this is the time that has elapsed.  
Public Property Gets/Sets the number of milliseconds to wait for a request from the FTP server. The default is to wait 30000 (30 seconds).  
Public Property Return a list of all the time zones and their GMT offset. This can be used to populate a drop down list similar to the Date Property Dialog in Windows XP or Windows Vista.  
Public Property When EnableSSL is true, the default is to use AUTH TLS when connecting. If this property is set to true, use AUTH SSL  
Public Property If true, use binary transfer mode else use ascii mode. The default mode is binary.  
Public Property Issue a CCC (Clear Command Channel) after connecting with SSL. Required for some FTP Servers when using a NAT.  
Public Property Uses the host IP Address instead of the PASV IP Address Response. Sometimes required when using a NAT.  
Public Property Use Mode Z Compression for Data Transfers  
Public PropertyIf true, use passive FTP mode. The default is passive mode.  
Public Property By default, Port 990 means implicit SSL. Setting to false will allow non-ssl on port 990 or explicit SSL on port 990  
Public PropertySpecifies the user name to use while communicating with the FTP Server.  
Public Property When UseStandardDirectoryListing is true, a MLSD command is given to get the directory listing instead of the LIST command. Permissions are not available with MLSD  
Public Property Use UTF-8 encoding  
Top
Protected Properties
 NameDescription
Protected Property  
Protected Property  
Protected Property  
Protected Property Custom object that the user sets during an async transfer  
Protected Property  
Protected Property  
Protected Property The last time we made a successfull connection  
Top
See Also

Reference

FTP Class
KellermanSoftware.NetFtpLibrary Namespace