Building a Simple FTP Application Using C# 2.0
 
Published: 04 Apr 2007
Abstract
This article demonstrates how to create a simple FTP application using C# 2.0 with the help of code samples.
by Mohammed Habeeb
Feedback
Average Rating: 
Views (Total / Last 10 Days): 93184/ 137

Introduction

An addition to the Microsoft .NET Framework 2.0 to 1.x is the support for FTP. All these days we had to rely on 3rd party libraries which suited most of our needs, but for sure, there is an extra pleasure using the .net framework library classes. The code included is not designed to be a full-fledged reusable library, but rather an easy to use and reusable pieces of code which is easily comprehensible and can be reused and tweaked to fit your specific needs. Therefore, the code for each functionality (upload, download, delete etc…) can be easy picked up separately and reused. The main motive behind this article was the unavailability of .NET 2.0 FTP sample codes and their usage in C#; may be because it is a new entrant to the .NET scenario or the third party implementations available were working pretty well, but this area of the .NET 2.0 library has not gotten enough focus.

Background

I started working on this FTP module as part of my official work, but the requirement soon changed and I had to do it for .NET 1.1. So, I have not traveled deeper into the rabbit hole. But I believe this gives a good, instant start for using the FTP support in .NET 2.0.

Code

First, you should add the following directives:

Listing 1 - Directives

using System.Net;
using System.IO;

The following steps can be considered as a generic procedure of getting an FTP request executed using FtpWebRequest object.

1.    Create an FtpWebRequest object over an ftp server URI.

2.    Set the FTP method to execute (upload, download, etc.).

3.    Set the options (SSL support, transfer as binary/not etc.) for the FTP webrequest.

4.    Set the login credentials (username, password).

5.    Execute the request.

6.    Receive the response stream (if required).

7.    Close the FTP Request, in addition to any open streams.

One point to watch out while coding for any FTP application is to have the settings for the ftp request proper to suit the ftp server and its specific configurations. FtpWebRequest object exposes many properties to have these settings in place.

The sample for the upload functionality is as follows:

First a URI is created which represents the FTP address along with the filename (directory structure included). This URI is used to create the FtpWebRequest instance.
Then properties of the FtpWebRequest object are set, which determines the settings for the ftp request. Some of its important properties are:

Credentials - Specifies the username and password to login to the FTP server.

KeepAlive - Specifies if the control connection should be closed or not after the request is completed. By default it is set to true.

UseBinary - Denotes the datatype for file transfers. The 2 modes of file transfer in this case are Binary and ASCII. At bit level both vary in the 8th bit of a byte. ASCII uses 8th bit as insignificant bit for error control, where as, for binary all the 8 bits are significant. So take care when you go for the ASCII transmission. To be simple, all those files that open and read well in notepad are safe as ASCII. Executables, formatted docs, etc. should be sent using binary mode. BTW sending ASCII files as binary works fine most of the time.

UsePassive - Specifies to use either active or passive mode. Earlier active FTP worked fine with all clients, but now a days as most of the random ports will blocked by firewall and the active mode may fail. The passive FTP is helpful in this case, but still it causes issues at the server. The higher ports requested by client on server may also be blocked by firewall. But since FTP servers will need to make their servers accessible to the greatest number of clients, they will almost certainly need to support passive FTP. The reason why passive mode is considered safe is that it ensures all data flow initiation comes from inside (client) the network rather than from the outside (server).

Contentlength - Setting this property is useful for the server we request to, but is not of much use for us (client) because FtpWebRequest usually ignores this property value, so it will not be available for our use in most of the cases. If we set this property, the FTP server will get an idea in advance about the size of the file it should expect (in case of upload).

Method - Denotes what action (command) to take in the current request (upload, download, filelist, etc.).  It is set a value defined in the WebRequestMethods.Ftp structure.

Listing 2 - Upload

private void Upload(string filename)
{
    FileInfo fileInf = new FileInfo(filename);
    string uri = "ftp://" + 
 ftpServerIP + "/" + fileInf.Name;
    FtpWebRequest reqFTP;
 
    // Create FtpWebRequest object from the Uri provided
    reqFTP = 
 (FtpWebRequest)FtpWebRequest.Create(new Uri("ftp://" + ftpServerIP + 
 "/" + fileInf.Name));
 
    // Provide the WebPermission Credintials
    reqFTP.Credentials = new NetworkCredential(ftpUserID, ftpPassword);
 
    // By default KeepAlive is true, where the control connection is not closed
    // after a command is executed.
    reqFTP.KeepAlive = false;
 
    // Specify the command to be executed.
    reqFTP.Method = WebRequestMethods.Ftp.UploadFile;
 
    // Specify the data transfer type.
    reqFTP.UseBinary = true;
 
    // Notify the server about the size of the uploaded file
    reqFTP.ContentLength = fileInf.Length;
 
    // The buffer size is set to 2kb
    int buffLength = 2048;
    byte[] buff = new byte[buffLength];
    int contentLen;
 
    // Opens a file stream (System.IO.FileStream) to read the file to be uploaded
    FileStream fs = fileInf.OpenRead();
 
    try
    {
        // Stream to which the file to be upload is written
        Stream strm = reqFTP.GetRequestStream();
 
        // Read from the file stream 2kb at a time
        contentLen = fs.Read(buff, 0, buffLength);
 
        // Till Stream content ends
        while (contentLen != 0)
        {
            // Write Content from the file stream to the FTP Upload Stream
            strm.Write(buff, 0, contentLen);
            contentLen = fs.Read(buff, 0, buffLength);
        }
 
        // Close the file stream and the Request Stream
        strm.Close();
        fs.Close();
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message, "Upload Error");
    }
}

Above is a sample code for FTP Upload (PUT). The underlying sub command used is STOR. Here an FtpWebRequest object is made for the specified file on the ftp server.
Different properties are set for the request, namely Credentials, KeepAlive Method, UseBinary, ContentLength.

The file in our local machine is opened and the contents are written to the FTP request stream. Here a buffer of size 2kb is used as an appropriate size suited for upload of larger or smaller files.

Listing 3 - Download

private void Download(string filePath, string fileName)
{
    FtpWebRequest reqFTP;
    try
    {
        //filePath = <<The full path where the file is to be created. the>>, 
        //fileName = <<Name of the file to be createdNeed not name on FTP server. name name()>>
        FileStream outputStream = new FileStream(filePath + "\\" + fileName, FileMode.Create);
 
        reqFTP = (FtpWebRequest)FtpWebRequest.Create(new 
 Uri("ftp://" + ftpServerIP + "/" + fileName));
        reqFTP.Method = WebRequestMethods.Ftp.DownloadFile;
        reqFTP.UseBinary = true;
        reqFTP.Credentials = new NetworkCredential(ftpUserID, ftpPassword);
        FtpWebResponse response = (FtpWebResponse)reqFTP.GetResponse();
        Stream ftpStream = response.GetResponseStream();
        long cl = response.ContentLength;
        int bufferSize = 2048;
        int readCount;
        byte[] buffer = new byte[bufferSize];
 
        readCount = ftpStream.Read(buffer, 0, bufferSize);
        while (readCount > 0)
        {
            outputStream.Write(buffer, 0, readCount);
            readCount = ftpStream.Read(buffer, 0, bufferSize);
        }
 
        ftpStream.Close();
        outputStream.Close();
        response.Close();
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message);
    }
}

Above is a sample code for Download of file from the FTP server. Unlike the Upload functionality described above, Download would require the response stream, which will contain the content of the file requested.

Here the file to download is specified as part of the Uri which in turn is used for the creation of the FtpWebRequest object. To "GET" the file requested, get the response of the FtpWebRequest object using GetResponse() method. This new response object built provides the response stream, which contain the file content as stream that you can easily convert to a file stream to get the file in place.

Note: We have the flexibility to set the location and name of the file under which it is to be saved on our local machine.

Listing 4 – Retrieve Filelist on FTP Server

public string[] GetFileList()
{
    string[] downloadFiles;
    StringBuilder result = new StringBuilder();
    FtpWebRequest reqFTP;
    try
    {
        reqFTP = (FtpWebRequest)FtpWebRequest.Create(new Uri("ftp://" + ftpServerIP + "/"));
        reqFTP.UseBinary = true;
        reqFTP.Credentials = new NetworkCredential(ftpUserID, ftpPassword);
        reqFTP.Method = WebRequestMethods.Ftp.ListDirectory;
        WebResponse response = reqFTP.GetResponse();
        StreamReader reader = new StreamReader(response.GetResponseStream());
 
        string line = reader.ReadLine();
        while (line != null)
        {
            result.Append(line);
            result.Append("\n");
            line = reader.ReadLine();
        }
        // to remove the trailing '\n'
        result.Remove(result.ToString().LastIndexOf('\n'), 1);
        reader.Close();
        response.Close();
        return result.ToString().Split('\n');
    }
    catch (Exception ex)
    {
        System.Windows.Forms.MessageBox.Show(ex.Message);
        downloadFiles = null;
        return downloadFiles;
    }
}

Above is a sample block of code for getting the file list on the ftp server. The Uri is built specifying the FTP server address/name and the required path if any. In the above example the root folder is specified for the creation of the FtpWebRequest object. Here the response stream is used for the creation of a StreamReader object, which has the whole list of file names on the server separated by "\r\n." this is the newline and carriagereturn together. You can get the whole file list ("\r\n" separated) using the ReadToEnd() method of the StreamReader object. The above implementation reads each file name and creates a StringBuilder object by appending each file name. The resultant StringBuilder object is split into a string array and returned. I am sure there are better ways to do it like removing the whole '\r" instances from the whole list (returned by <<StreamReader>>.ReadToEnd())) and split the resultant string uisng "\n" delimiter. Anyway, I did not want to spend more of my energy and time pondering over it.

The implementations for Rename, Delete, GetFileSize, FileListDetails, MakeDir are very similar to the above pieces of code and the attached code is easily comprehensible.

Note: For Renaming, the new name can be assigned to the RenameTo property of FtpWebRequest object. For MakeDirectory, the name of the new directory can be specified as part of the Uri used to create FtpWebRequest object.

Points of Interest

Please take note of the following points while coding in this area.

Unless the EnableSsl property is true, all data and commands, including your user name and password information, are sent to the server in clear text. Anyone monitoring network traffic can view your credentials and use them to connect to the server. If you are connecting to an FTP server that requires credentials and supports Secure Sockets Layer (SSL), you should set EnableSsl to true.

If you do not have the proper WebPermission to access the FTP resource, a SecurityException exception is thrown.

Requests are sent to the server by calling the GetResponse method. When the requested operation completes, an FtpWebResponse object is returned. The FtpWebResponse object provides the status of the operation and any data downloaded from the server. That is,
StatusCode property of FtpWebResponse object provides the latest status code returned by the FTP server. StatusDescription property of FtpWebResponse object provides the description of the status code returned.

Downloads

Demo Application: [Download Sample]

Source Code: [Download Sample]

Conclusion

This article examined how to create a sample FTP application using C# 2.0.



User Comments

Title: Thank you very much   
Name: narmada
Date: 2012-11-05 8:11:56 AM
Comment:
Nice Article
Now i came to know how to upload file to ftp server thank you very much
Title: how to transfer(upload/download) a file where it gets stopped due to network failure,it must resume from the last written byte   
Name: Batuk
Date: 2011-01-19 12:42:19 AM
Comment:
Nice Article

I know how to upload and download
but i wanted help on how to transfer(upload/download) a file where it gets stopped due to network failure,it must resume from the last written byte

can you help me out??????
Title: Building a simple FTP Application Using C# .0   
Name: how can i Download and Upload ?
Date: 2010-12-21 8:18:47 AM
Comment:
the First ,i want to give you a word Thanks.
the Second,i have a question.
how can i download a file from FTP Server .how can i upload a file form Server.can my Desktop do Server?
Title: Request   
Name: Ssn
Date: 2010-10-29 3:09:45 AM
Comment:
Thanks for your article,
Will you please tell how can i download a file from ftp server using the download prompt dialog. so that i can save the file to location i needed. Thanks in advance
Title: Building a Simple FTP Application Using C# 2.0   
Name: Download example is not complete
Date: 2010-08-03 6:18:04 AM
Comment:
In your download example you miss ftpStream.Flush() during the while. When downloading a number of files this missing flush() becomes clearly.
Title: Thank you   
Name: Daniel
Date: 2010-07-26 7:00:26 AM
Comment:
Thank you, This was very useful for an application i am currently working on.
Title: Great article   
Name: Gustavo Siqueira
Date: 2010-07-19 2:05:36 PM
Comment:
Great article!
Title: Excelente el Post   
Name: Armando Iglesias -- Venezuela
Date: 2010-05-21 9:34:50 PM
Comment:
Excelente el articulo, gracias fue muy util
Title: Cool Post   
Name: Ashish Khudlani
Date: 2010-05-07 8:08:58 AM
Comment:
Ultimate Code Dude it worked perfectly file.
Title: Nice job!   
Name: Steve
Date: 2010-04-24 10:57:41 AM
Comment:
Just echoing others comments. Nice clean example. Thanks!
Title: Error   
Name: John
Date: 2010-04-12 6:53:44 AM
Comment:
It's a very nice code but it gives me an error when I'm trying to connect to my server at-reqFTP.Method = WebRequestMethods.Ftp.UploadFile:

"The method is not supported.Parameter name:value"
How can i solve this problem, or why is appearing?
Title: what about directory Exist option   
Name: Adit
Date: 2010-03-30 9:10:28 AM
Comment:
Hi,
I was wondering there is a MakeDirectory webMethod but what if I want to check if Directory does not exist and only then create the directory. I know I can List Directory and iterate through there but is there a shorter way.

Thanks in advance
Title: Thanks   
Name: Ocar
Date: 2010-03-15 8:38:57 AM
Comment:
Thank you!
Title: Thanks   
Name: David
Date: 2010-03-10 2:18:45 PM
Comment:
Thank you so much for putting this together. I needed to dynamically pick up data with ssis and the ftp task wasn't dynamic enough.
Title: Well written article   
Name: jacob
Date: 2010-02-12 5:04:52 PM
Comment:
This is what I have been looking for. Easy to understand and concise.
Title: great but......   
Name: Nitin
Date: 2010-02-09 12:47:01 AM
Comment:
Its a great code...but here we have to provide our ftp user id and password which i cant. Is there any other way where we dont need to provide ftp user id and password, if so then let me know plz?

Thanks
Title: great   
Name: waqas
Date: 2010-02-08 5:47:59 AM
Comment:
thats what i was looking for.
thanks
Title: GREAT!!   
Name: Andrea
Date: 2010-01-12 12:23:52 PM
Comment:
You solve my problem... great article!!
Thanks from Italy
Title: shokrn   
Name: mido egypt
Date: 2010-01-08 10:52:15 AM
Comment:
very very good
Title: Retrieve more than one file   
Name: Sergio Salanitri
Date: 2009-11-23 11:04:06 AM
Comment:
Goog article. My question es ¿How I retrive more than one file without execute Connect statemente for each file?

Thanks.
Title: Meet the expectation   
Name: Mahbub
Date: 2009-08-17 10:10:40 PM
Comment:
Thanks for your nice article along with code. I think it is very much helpful for us. Expecting more articles from you.
Title: Thanks a lot   
Name: John
Date: 2009-08-09 1:16:48 AM
Comment:
Thanks a lot, man.
This is exactly what I was looking for.
I searched the whole internet for FTP operations using C# and .net libraries. I could find some on MSDN, but it was not easy to understand and takes a long time to read. Your article is upto the point and very much reusable. This was a quick requirement for our business and you saved us.
Hoping to see more articles from you.

Thanks Again,
John
Title: Simple and informative   
Name: Faisal Lodhi
Date: 2009-06-21 6:41:02 AM
Comment:
Thanks for the article






Community Advice: ASP | SQL | XML | Regular Expressions | Windows


©Copyright 1998-2020 ASPAlliance.com  |  Page Processed at 2020-08-09 1:44:45 PM  AspAlliance Recent Articles RSS Feed
About ASPAlliance | Newsgroups | Advertise | Authors | Email Lists | Feedback | Link To Us | Privacy | Search