Click here to Skip to main content
15,867,568 members
Articles / Programming Languages / Visual Basic

An FTP client library for .NET 2.0

Rate me:
Please Sign up or sign in to vote.
4.84/5 (178 votes)
17 Aug 2017CPOL6 min read 3.4M   37.6K   461   1K
Provides a useful wrapper to the FtpRequest in .NET 2.0.

Introduction

Update:

With the pending Codeplex shutdown I have ported the source to a GitHub repository.

One annoying omission from the 1.x framework for .NET was support for FTP. This could be rectified by various libraries (some free, others commercial) that filled this gap. However, with Visual Studio 2005 and 2.0 of the .NET framework, FTP makes a welcome appearance.

As well as adding FTP, Microsoft has moved support for web, mail and FTP requests out of System.Web and into System.Net which is a more logical approach.

There is still a problem however: the FTP support isn't actually an FTP client, it's just support for the protocol in FtpWebRequest, in the same way as HttpWebRequest supports web requests. There is no "download a file" or "get a directory listing" function - you're still left to sort this out yourself.

This is where I hope my library FTPclient will come in useful. It's not a full-featured and comprehensive client but it provides all the most frequently used functions and can act as a base to add any missing ones if you need them.

Background

I assume here that you've got .NET 2.0 or one of the betas. This library was written on beta 2 of VS2005, so if you have a later version or the released version some changes may be required. I'll try to update the code if any framework changes break it.

I wrote this library to support my own application which needed to upload and download files to a supplier's FTP server: this runs on Linux, but I also tested it against the Microsoft FTP server that comes with NT and XP.

FTPClient Design

FTPclient is designed to operate in a stateless mode, in a similar way to how a web request would work. It does not hold open a connection but instead will connect, perform the requested action, and disconnect for each request.

This does mean it's very suitable for single-action operations but not ideal in performance terms if you want to hold open a connection while performing multiple requests. However the library could be adapted to operate in this way if someone is willing to take the time.

FtpWebRequest Basics

Making any type of FTP requests can be broken down into six steps:

  • Create a web request for a URL.
  • Set the login credentials (username, password).
  • Set the required options and the action to perform.
  • Upload data required (not used by some actions).
  • Download data or results (again, not used by some actions).
  • Close the request (and connection).

Although this might seem simple enough, there are several problems that can catch you out (they did for me!). One is that FtpWebRequest can support connections using the KeepAlive property, which is set to True by default. In my class it's turned off so that each connection is closed once the command completes.

An Example: Download a file

Here is an example of the steps in action, using FtpWebRequest to download a file:

VB
'Values to use
Const localFile As String = "C:\myfile.bin"
Const remoteFile As String = "/pub/myftpfile.bin"
Const host As String = "ftp://ftp.myhost.com"
Const username As String = "myuserid"
Const password As String = "mypassword"

'1. Create a request: must be in ftp://hostname format, 
'   not just ftp.myhost.com
Dim URI As String = host & remoteFile
Dim ftp As System.Net.FtpWebRequest = _
    CType(FtpWebRequest.Create(URI), FtpWebRequest)

'2. Set credentials
ftp.Credentials = New _
    System.Net.NetworkCredential(username, password)

'3. Settings and action
ftp.KeepAlive = False
'we want a binary transfer, not textual data
ftp.UseBinary = True
'Define the action required (in this case, download a file)
ftp.Method = System.Net.WebRequestMethods.Ftp.DownloadFile

'4. If we were using a method that uploads data e.g. UploadFile
'   we would open the ftp.GetRequestStream here an send the data

'5. Get the response to the Ftp request and the associated stream
Using response As System.Net.FtpWebResponse = _
      CType(ftp.GetResponse, System.Net.FtpWebResponse)
  Using responseStream As IO.Stream = response.GetResponseStream
    'loop to read & write to file
    Using fs As New IO.FileStream(localFile, IO.FileMode.Create)
      Dim buffer(2047) As Byte
      Dim read As Integer = 0
      Do
        read = responseStream.Read(buffer, 0, buffer.Length)
        fs.Write(buffer, 0, read)
      Loop Until read = 0 'see Note(1)
      responseStream.Close()
      fs.Flush()
      fs.Close()
    End Using
    responseStream.Close()
  End Using
  response.Close()
End Using

'6. Done! the Close happens because ftp goes out of scope
'   There is no .Close or .Dispose for FtpWebRequest

Note (1): I found that using Loop Until read < buffer.Size does not work because sometimes data less than the buffer size is returned by a remote server, and it was possible to have this condition true before the end of the stream is reached. I found that read = 0 seems to only occur once the stream is finished.

In this particular example, steps 1 and 2 would be repeated for any type of FTP operation in the same way, so I put them into a function that can be re-used. Step 3 is largely dependent on the operation you will perform, as is the type of upload or download, but I created a generic function GetResponseString that will read a textual response (e.g. a directory listing). This code also lacks any error handling.

Using FtpClient

To use FtpClient, create a new instance of the object, defining the host, username and password.

VB
Dim myFtp As New FtpClient(hostname, username, password)

To get a directory listing of the FTP server's /pub directory:

VB
Dim fullList As FtpDirectory = myFtp.GetDirectoryDetail("/pub/")

To determine which of these are files, use the GetFiles function:

VB
Dim filesOnly As FtpDirectory = fullList.GetFiles()

To download or upload a file - a simple example:

VB
myFtp.Download("/pub/myfile.bin", "C:\myfile.bin")
myFtp.Upload("C:\myfile.bin", "/pub/myfile.bin")

Or a more complex example, downloading all the files from a directory.

VB
For Each file As FtpFileInfo In myFtp.GetDirectoryDetail("/pub/").GetFiles
    myFtp.Download(file, "C:\" & file.Filename)
Next file

If a target file already exists for either uploads or downloads, the client will throw an exception by default to prevent unwanted overwrites. To turn off this behaviour, set the last, optional parameter PermitOverwrite to True.

Reading FTP Directories

Reading an FTP directory is simple enough: use either ListDirectory or ListDirectoryDetails request methods. ListDirectory is very simple - it returns a List(Of String) - but there is no distinction between a file or directory entry in the list so it may not be of use in most cases.

ListDirectoryDetails provides a lot more information about each file. It uses the detailed FTP listing which returns a collection of FtpFileInfo objects. An FtpFileInfo object contains the full path, name, date/time and file size of the entry as read from the detailed directory listing, in a similar way to FileInfo from System.IO.

Detailed FTP directory listings output varies according to the FTP server and the operating system it runs on. In particular, the NT/XP FTP server can be very different to UNIX and Linux results. The constructor for FtpFileInfo takes the text of the listing as a parameter and attempts to parse this with several regular expression patterns (held in _ParseFormats).

If you have errors with a particular FTP server reading detailed directories, you may need to add your own regular expressions to the _ParseFormats string array to get the library to work. I would expect the ones provided will work with most servers. Let me know if you find any new patterns that are needed.

Current Directory

I included the capability to store a current directory in the design in the same style as a standard FTP client application, although I've not used this myself. To set the directory, use FtpClient.CurrentDirectory = "/path". This comes into play if you don't specify a path for a remote file.

VB
Dim myFtp As New FtpClient(hostname, username, password)
myFtp.CurrentDirectory = "/pub"
myFtp.Download("fileInPub.bin", "C:\test\fileInPub.bin")

myFtp.CurrentDirectory = "/pub/etc"
'will upload to file /pub/etc/MyFile.bin
myFtp.Upload("C:\MyFile.bin")

Possible Improvements

As mentioned already, this client does not support using an open connection, and has to log in for each request. In my application this wasn't a big issue, and I found the support for keeping the connection alive and performing multiple requests inadequately documented, so I decided to KISS (Keep It Simple).

Another improvement could be adding support for asynchronous operations which the FtpWebRequest object supports, but again KISS prevailed in my project.

Anyway, I hope you find this a useful little library that should do the basic operations you need for FTP.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Architect
United Kingdom United Kingdom
Developer, business person, etc.

Comments and Discussions

 
GeneralRe: Error in retrieving file dates Pin
Howard Richards6-Nov-11 22:20
Howard Richards6-Nov-11 22:20 
GeneralRe: Error in retrieving file dates Pin
andreyakub14-Nov-11 22:13
andreyakub14-Nov-11 22:13 
GeneralRe: Error in retrieving file dates Pin
Howard Richards15-Nov-11 1:26
Howard Richards15-Nov-11 1:26 
GeneralRe: Error in retrieving file dates Pin
hareshet11-Jan-12 20:55
hareshet11-Jan-12 20:55 
QuestionProblem using FTP Client on machines with Norton 360 Antivirus software Pin
andreyakub24-Oct-11 21:50
andreyakub24-Oct-11 21:50 
AnswerRe: Problem using FTP Client on machines with Norton 360 Antivirus software Pin
Howard Richards25-Oct-11 3:51
Howard Richards25-Oct-11 3:51 
GeneralRe: Problem using FTP Client on machines with Norton 360 Antivirus software Pin
andreyakub4-Nov-11 21:04
andreyakub4-Nov-11 21:04 
GeneralRe: Problem using FTP Client on machines with Norton 360 Antivirus software Pin
Howard Richards6-Nov-11 22:21
Howard Richards6-Nov-11 22:21 
The tail cannot wag the dog. If the AV software is preventing something you have to fix that, not the affected software. So no I can't help you.
'Howard

GeneralRe: Problem using FTP Client on machines with Norton 360 Antivirus software Pin
andreyakub11-Nov-11 20:26
andreyakub11-Nov-11 20:26 
GeneralRe: Problem using FTP Client on machines with Norton 360 Antivirus software Pin
Howard Richards13-Nov-11 21:37
Howard Richards13-Nov-11 21:37 
GeneralRe: Problem using FTP Client on machines with Norton 360 Antivirus software Pin
andreyakub14-Nov-11 22:12
andreyakub14-Nov-11 22:12 
GeneralRe: Problem using FTP Client on machines with Norton 360 Antivirus software Pin
apaulsavage30-Oct-13 5:16
apaulsavage30-Oct-13 5:16 
BugRelative directory listing does not always work Pin
Member 82788795-Oct-11 5:03
Member 82788795-Oct-11 5:03 
GeneralRe: Relative directory listing does not always work Pin
Howard Richards13-Nov-11 21:39
Howard Richards13-Nov-11 21:39 
QuestionHelp Pin
kire_1220-Sep-11 3:20
kire_1220-Sep-11 3:20 
Questionprogress bar Pin
erfg128-Aug-11 11:30
erfg128-Aug-11 11:30 
GeneralMy vote of 5 Pin
JohnCollett23-Aug-11 14:41
JohnCollett23-Aug-11 14:41 
QuestionCan't Log In To Root Directory Pin
Directiz30-Jul-11 2:10
Directiz30-Jul-11 2:10 
AnswerRe: Can't Log In To Root Directory Pin
CeremBeyazit10-Dec-11 5:05
CeremBeyazit10-Dec-11 5:05 
QuestionProblem reading directory from German Provider 1 und 1 Pin
Carsten Giesen28-Jun-11 3:50
Carsten Giesen28-Jun-11 3:50 
GeneralMy vote of 5 Pin
ravi samsher6-Jun-11 21:01
ravi samsher6-Jun-11 21:01 
GeneralMy vote of 4 Pin
Nghia dinh Trong5-Jun-11 18:25
Nghia dinh Trong5-Jun-11 18:25 
GeneralAppriciate Pin
vimlapatel11-May-11 2:27
vimlapatel11-May-11 2:27 
GeneralMy vote of 4 Pin
SCampbell5558-Apr-11 0:29
SCampbell5558-Apr-11 0:29 
GeneralSome Issues regarding Regex and Special Characters like äöü Pin
plundy23-Mar-11 6:58
plundy23-Mar-11 6:58 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.