Edit this page

Getting Started

RadUpload has a client and a server side part. The client side is executed entirely in the browser using the Silverlight platform. The server side requires a handler on the server for processing the files that are submitted from the client side. This topic will explain the basics of:

Configuring the server side

The first thing you have to do is to add a reference to the Telerik.Windows.RadUploadHandler assembly in the ASP.NET application that hosts your Silverlight application. After that create a Generic (ASHX) Handler, that derives from the RadUploadHandler class.

[C#] Example 1: Create a generic handler

public class SampleUploadHandler : RadUploadHandler

[VB.NET] Example 1: Create a generic handler

Public Class SampleUploadHandler
 Inherits RadUploadHandler
End Class

Create a folder, in which the uploaded files will be stored.

Please note that the target folder should be in the same folder as the upload handler.

To test the handler point your browser to the SampleUploadHandler.ashx file. You should see the following output if everything is done correctly.

Configuring the client side

The first thing you have to do on the client side is to declare a RadUpload control in the appropriate UserControl.

In order to use RadUpload control in your projects you have to add references to the following assemblies:
1. Telerik.Windows.Controls
2. Telerik.Windows.Controls.Input
You can find more info here.

[XAML] Example 2: RadUpload definition

<UserControl x:Class="RadUploadSamples.GettingStarted"
    <Grid x:Name="LayoutRoot" Background="White">
        <telerik:RadUpload />

Next you have to set the UploadServiceUrl property of the RadUpload. The value can be an absolute or relative url that points to the upload handler.

The domain where the Silverlight application is hosted should be the same as the domain where the upload handler is hosted, otherwise a cross-domain conflict will occur. In such case you have to add a Cross-Domain Policy file to the services domain.

For example, if you rely on the absolute path, the UploadServiceUrl should point to http://localhost:6519/SampleUploadHandler.ashx and the Silverlight application should be hosted on the same domain - for example on this url: http://localhost:6519/index.html. Note that the port of the application should be the same (in this case the port is set to 6519, but any other port - including the default port 80 - will work).

If you prefer the relative path then pay attention to the following things:

  • if the path begins with "/" or "~/" then it is relative to the root of the domain where the Silverlight application had been loaded.

  • if the path begins with "./" then it is relative to the location of the Silverlight application.

  • if the path begins with one or more "../", then it is relative to the location above the location of the Silverlight application.

[XAML] Example 3: Setting the upload service URL property

<telerik:RadUpload UploadServiceUrl="/SampleUploadHandler.ashx" />

The last thing to do is to set the TargetFolder property. The TargetFolder should point to the folder that is configured to accept the uploaded files. In our case the TargetFolder should be set to "UserUploads".

Please note that the TargetFolder property represents the path relative to the upload handler.

[XAML] Example 4: Setting the target folder

<telerik:RadUpload UploadServiceUrl="/SampleUploadHandler.ashx"
                   TargetFolder="UserUploads" />

This is enough to make the RadUpload work. To fine tune the upload to match your application requirements, read the following topics.

See Also