Click here to Skip to main content
15,851,335 members
Articles / Programming Languages / Visual Basic

Progress Indication while Uploading/Downloading Files using WCF

Rate me:
Please Sign up or sign in to vote.
4.92/5 (66 votes)
4 Feb 2009CPOL5 min read 508K   14.6K   244   138
This article examines the implementation of upload and download functionality with progress indication (progress bar feature) using Windows Communication Foundation.
Screenshot - WCF_FileTransfer_Progress.png

Introduction

This article examines the implementation of upload and download functionality with progress indication (progress bar feature) using the Windows Communication Foundation. For this sample, you will need Visual Studio 2008.

The sample code consists of three projects bundled in a solution. A brief description of these projects follows. The attached sample code is available in C# and VB.NET (conversion to VB.NET was made by Lee Galloway of Project Time and Cost).

FileService

This is the main server project.

The Server Contract

The File Server project includes FileTransferServiceContract.cs file, which contains the IFileTransferService interface. This interface describes the operations provided by our server. No actual work is done in this code file except in describing the operations provided. If you've worked with service-oriented applications before, you'll know that this job is important enough to spare a separate file for. Here are the two operations of our file transfer service:

  • DownloadFile Server Method

    Accepts a DownloadRequest instance that contains the name of the file to be downloaded by the client. It returns a RemoteFileInfo instance, defined in the same code file. RemoteFileInfo contains the name of the file to be downloaded, the file stream and the length of the file in bytes. This instance of the RemoteFileInfo class will be used by the client to download the file. You notice that filename and length are marked with the MessageHeader attribute in the RemoteFileInfo class. This is because when a message contract contains a stream, this can be the only body member of the contract.

  • UploadFile Server Method

    Accepts an instance of the RemoteFileInfo message contract. This is the same as used in DownloadFile, only in this case the length property is not required.

CS

C#
[ServiceContract()]
public interface IFileTransferService
{
    [OperationContract()]
    void UploadFile(RemoteFileInfo request);

    [OperationContract]
    RemoteFileInfo DownloadFile(DownloadRequest request);
}

public class RemoteFileInfo
{
    [MessageHeader(MustUnderstand = true)]
    public string FileName;

    [MessageHeader(MustUnderstand = true)]
    public long Length;

    [MessageBodyMember(Order = 1)]
    public System.IO.Stream FileByteStream;
}

VB

VB.NET
<ServiceContract()> _
<servicecontract() />Public Interface IFileTransferService

    <OperationContract()> _
    Sub UploadFile(ByVal request As RemoteFileInfo)

    <OperationContract()> _
    Function DownloadFile(ByVal request As DownloadRequest) As RemoteFileInfo

End Interface

<MessageContract()> _
Public Class RemoteFileInfo
    Implements IDisposable

    <OperationContract()> _
    Public FileName As String

    <OperationContract()> _
    Public Length As Long

    <MessageBodyMember(Order:=1)> _
    Public FileByteStream As System.IO.Stream

End Class

The Server Implementation

File Server also includes the FileTransferService.cs code file which contains the implementation of the contract, i.e. the actual code that does all the work. Apparently the included class implements the IFileTransferService class, which constitutes the service contract. If you have worked with streams before in .NET, you will find out that the code that handles the stream and related information for upload or download is pretty straightforward. If you are new to .NET streams, please use Google for a quick introduction.

Note here that since actual downloading of the file starts after the execution of the DownloadFile method is completed (i.e. after the client gets the RemoteFileInfo instance returned by this method), the server must close the opened stream later, after the client completes the process. An elegant approach was suggested by Buddhike. To do this, the IDisposable interface is implemented by the RemoteFileInfo contract and the stream is disposed on the corresponding Dispose method. If this is not done, the stream will remain locked and the corresponding file will be locked for writing.

ConsoleHost

FileService is a class library and hence it cannot start as a window process. Therefore it needs another executable file-process that will host it. Several types of processes can host a WCF service, such as .NET executables, IIS processes, Windows Activation Services (new feature of Vista) and many more. Our example uses a .NET executable to host our service. So, ConsoleHost is a console application that does exactly this. It has a reference to the FileService project. However, it is not related in any way with the business our service is doing, i.e. transferring files. Actually, the code you will find in Program.cs would be the same even if our service was designed to host an online grocery. Take a quick look at this code file to understand how our service is started and closed.

CS

C#
static void Main(string[] args)
{
    ServiceHost myServiceHost = new ServiceHost
                (typeof(FileService.FileTransferService));
    myServiceHost.Open();

    Console.WriteLine("This is the SERVER console");
    Console.WriteLine("Service Started!");
    foreach (Uri address in myServiceHost.BaseAddresses)
        Console.WriteLine("Listening on " + address.ToString());
    Console.WriteLine("Click any key to close...");
    Console.ReadKey();

    myServiceHost.Close();
}

VB

VB.NET
Public Shared Sub Main()

    Dim myServiceHost As New ServiceHost(_
        GetType(FileService.FileTransferService))
    myServiceHost.Open()

    Console.WriteLine("This is the SERVER console")
    Console.WriteLine("Service Started!")
    For Each address As Uri In myServiceHost.BaseAddresses
        Console.WriteLine("Listening on " + address.ToString())
    Next
    Console.WriteLine("Click any key to close...")
    Console.ReadKey()

    myServiceHost.Close()

End Sub

The configuration of ConsoleHost is what matters the most! It is divided into three sections, configuring the way our service will behave and how it will be exposed to the rest of the world. It is not the goal of this article to describe in detail how a WCF service is configured, so please refer to the WCF reference on MSDN for more information. Something noticeable in the configuration of our service is that it uses MTOM as message encoding and stream as transfer mode. See also the maxReceivedMessageSize property. This defines the maximum size of messages transferred by our service. Since we are transferring files, we want this property to have a large value.

XML

XML
<binding name ="FileTransferServicesBinding"
    transferMode="Streamed"
    messageEncoding="Mtom"
    maxReceivedMessageSize="10067108864" >
</binding>

Client

The Client project is a sample consumer of our service. You will notice that the Client project includes a folder called Service References. This folder contains a bunch of files created automatically by Visual Studio by right clicking on the Client project root and selecting "Add Service Reference." The files in this folder are the proxy of our file transfer service on the client side. Client is using these files to send requests to the server, hiding in this way the complexity of Web Service and SOAP protocols.

Again, if you have worked with streams before, you will notice that things are pretty simple in the TestForm file except for one small part, which is also the difference in implementing the progress indication when uploading rather than when downloading. When downloading, the client has control of the procedure. You can see in TestForm.cs that downloading is implemented using a loop that reads the server stream piece-by-piece. So, the client knows what part of the server stream is read and how many more remain. When uploading, that loop resides on the server. In order for the client to know how many bytes the server read, it uses the StreamWithProgress class, which inherits System.IO.Stream. An instance of this class is passed to the server, instead of the original file stream. Since this class overrides the default Read method of the stream (see code below), it can report the progress of the uploading process to the client!

CS

C#
public override
    int Read(byte[] buffer, int offset,
    int count)
{
    int result = file.Read(buffer, offset, count);
    bytesRead += result;
    if (ProgressChanged != null) 
    ProgressChanged(this, new ProgressChangedEventArgs(bytesRead, length));
    return result;
}

VB

VB.NET
Public Overloads Overrides Function Read(ByVal buffer As Byte(), _
    ByVal offset As Integer, ByVal count As Integer) As Integer
    Dim result As Integer = file.Read(buffer, offset, count)
    bytesRead += result
    RaiseEvent ProgressChanged(Me, New ProgressChangedEventArgs(_
        bytesRead, m_length))
    Return result
End Function

History

  • Updated on 2007/09/09: A more elegant approach for the server implementation was suggested by Buddhike.
  • Updated on 2007/10/24: Code now also provided in VB.NET. Conversion made by Lee Galloway of Project Time and Cost.
  • Updated on 2009/02/03:
    • Upgraded projects to Visual Studio 2008 (.NET Framework 2.0 is still the target framework).
    • Properly closing read stream on client when download is done. Failure to do this was causing the client to throw timeout exceptions after 2 or 3 downloads.

License

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


Written By
Software Developer (Senior)
Luxembourg Luxembourg
Dimitris Papadimitriou is a Software Development Professional specialized in Microsoft technologies. He has been awarded with the Microsoft MVP award (Connected System Developer). He lives in Luxembourg. Read more in his personal web page.

Comments and Discussions

 
GeneralRe: WCF Service host through IIS Pin
Pratiksha Saxena30-Jul-08 19:01
Pratiksha Saxena30-Jul-08 19:01 
GeneralRe: WCF Service host through IIS Pin
SqlRanger6-Aug-08 13:46
SqlRanger6-Aug-08 13:46 
QuestionAm I missing the point? Pin
Member 187034920-Jul-08 9:28
Member 187034920-Jul-08 9:28 
AnswerRe: Am I missing the point? Pin
p8020-Aug-09 4:27
p8020-Aug-09 4:27 
GeneralCould not upload &gt; 4MB files if the WCF service hosting on IIS 6.0 Pin
Member 160681317-Feb-08 2:47
Member 160681317-Feb-08 2:47 
GeneralRe: Could not upload &gt; 4MB files if the WCF service hosting on IIS 6.0 Pin
redWingBB18-Feb-08 10:24
redWingBB18-Feb-08 10:24 
GeneralRe: Could not upload &gt; 4MB files if the WCF service hosting on IIS 6.0 Pin
SqlRanger6-Aug-08 13:41
SqlRanger6-Aug-08 13:41 
GeneralRe: Could not upload &gt; 4MB files if the WCF service hosting on IIS 6.0 Pin
Black Horus5-Feb-09 10:35
Black Horus5-Feb-09 10:35 
it's better to use streaming when dealing with large data... As you're using BasicHttpBinding (II6 doesn't support fancy binding), it should be easy to deal with this...
Questionproblem in running web project instead of selfhost or IIS host. [modified] Pin
PavanPT6-Jan-08 12:24
PavanPT6-Jan-08 12:24 
QuestionIIS 7 Pin
ccs21-Dec-07 23:10
ccs21-Dec-07 23:10 
GeneralRe: IIS 7 Pin
PavanPT6-Jan-08 14:09
PavanPT6-Jan-08 14:09 
QuestionUploading file in VB.net window application Pin
kk_upadhyay2-Nov-07 22:20
kk_upadhyay2-Nov-07 22:20 
AnswerRe: Uploading file in VB.net window application Pin
Dimitris Papadimitriou3-Nov-07 2:23
Dimitris Papadimitriou3-Nov-07 2:23 
GeneralClosing the streaming message Pin
Buddhike de Silva6-Sep-07 10:50
Buddhike de Silva6-Sep-07 10:50 
GeneralRe: Closing the streaming message Pin
Dimitris Papadimitriou6-Sep-07 11:04
Dimitris Papadimitriou6-Sep-07 11:04 
NewsRe: Closing the streaming message Pin
Dimitris Papadimitriou20-Sep-07 12:22
Dimitris Papadimitriou20-Sep-07 12:22 
GeneralRe: Closing the streaming message Pin
Buddhike de Silva25-Sep-07 4:02
Buddhike de Silva25-Sep-07 4:02 
GeneralUse the OperationCompleted event! Pin
fidgety7-Dec-08 10:49
fidgety7-Dec-08 10:49 
GeneralRe: Use the OperationCompleted event! Pin
Dimitris Papadimitriou7-Dec-08 10:54
Dimitris Papadimitriou7-Dec-08 10:54 
GeneralI like this Pin
Sacha Barber6-Sep-07 5:14
Sacha Barber6-Sep-07 5:14 
GeneralGood Info Pin
merlin9816-Sep-07 4:49
professionalmerlin9816-Sep-07 4:49 
QuestionFileTransferServicesBinding Pin
Eduard Gomolyako6-Sep-07 4:05
Eduard Gomolyako6-Sep-07 4:05 
AnswerRe: FileTransferServicesBinding Pin
papadi6-Sep-07 8:13
papadi6-Sep-07 8:13 

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.