ComponentOne Uploader for Silverlightprerelease.componentone.com/help/Silverlight/Silverlight... · 2015-07-17 · Uploader for Silverlight Quick Start > Step 1 of 4: Creating a Silverlight

ComponentOne

Uploader for Silverlight

Copyright © 1987-2015 GrapeCity, Inc. All rights reserved.

ComponentOne, a division of GrapeCity

201 South Highland Avenue, Third Floor

Pittsburgh, PA 15206 USA

Website: http://www.componentone.com

Sales: [email protected]

Telephone: 1.800.858.2739 or 1.412.681.4343 (Pittsburgh, PA USA Office)

Trademarks

The ComponentOne product name is a trademark and ComponentOne is a registered trademark of GrapeCity, Inc.

All other trademarks used herein are the properties of their respective owners.

Warranty

ComponentOne warrants that the media on which the software is delivered is free from defects in material and

workmanship, assuming normal use, for a period of 90 days from the date of purchase. If a defect occurs during this

time, you may return the defective media to ComponentOne, along with a dated proof of purchase, and

ComponentOne will replace it at no charge. After 90 days, you can obtain a replacement for the defective media by

sending it and a check for $25 (to cover postage and handling) to ComponentOne.

Except for the express warranty of the original media on which the software is delivered is set forth here,

ComponentOne makes no other warranties, express or implied. Every attempt has been made to ensure that the

information contained in this manual is correct as of the time it was written. ComponentOne is not responsible for

any errors or omissions. ComponentOne’s liability is limited to the amount you paid for the product. ComponentOne

is not liable for any special, consequential, or other damages for any reason.

Copying and Distribution

While you are welcome to make backup copies of the software for your own use and protection, you are not

permitted to make copies for the use of anyone else. We put a lot of time and effort into creating this product, and

we appreciate your support in seeing that it is used by licensed users only.

1

Table of Contents Uploader for Silverlight ................................................................................................................. 8

Help with ComponentOne Studio Silverlight Edition ................................................................ 8

Uploader for Silverlight Key Features ........................................................................................... 8

Uploader for Silverlight Quick Start .............................................................................................. 9

Step 1 of 4: Creating a Silverlight Application........................................................................... 9

Step 2 of 4: Adding Code to the Project ................................................................................. 10

Step 3 of 4: Implementing Server Code .................................................................................. 17

Step 4 of 4: Running the Application ...................................................................................... 20

Working with Uploader for Silverlight ........................................................................................ 21

Basic Properties ...................................................................................................................... 21

Basic Methods ......................................................................................................................... 22

Basic Events ............................................................................................................................ 22

Uploading Files ........................................................................................................................ 23

Silverlight and Local Files ........................................................................................................ 23

Maximum Upload Size ............................................................................................................ 24

Parameters .............................................................................................................................. 24

Uploader for Silverlight Samples ................................................................................................ 25

Uploader for Silverlight Task-Based Help ................................................................................... 25

Splitting Files ........................................................................................................................... 26

Cancelling a File Upload .......................................................................................................... 27

Determining whether C1Uploader is Busy.............................................................................. 27

Compressing and Uploading Files ........................................................................................... 28

Uploading and Previewing Files .............................................................................................. 37

API ............................................................................................................................................... 44

C1.Silverlight.Uploader.5 Assembly ........................................................................................ 44

Namespaces ........................................................................................................................ 44

C1.Silverlight.Uploader Namespace ............................................................................... 44

Overview ..................................................................................................................... 44

Classes ......................................................................................................................... 46

C1Uploader ............................................................................................................. 46

Overview ............................................................................................................. 47

Members ............................................................................................................. 48

Methods .............................................................................................................. 49

2

AddFile Method .............................................................................................. 50

AddFile(FileInfo) Method ............................................................................ 50

AddFile(String) Method ............................................................................... 51

AddFile(String,Stream) Method .................................................................. 52

AddFiles Method ............................................................................................. 53

BeginUploadFiles Method ............................................................................... 54

Cancel Method ................................................................................................ 55

Properties ............................................................................................................ 55

Files Property .................................................................................................. 56

Headers Property ............................................................................................ 56

IsBusy Property ............................................................................................... 57

MaximumUploadSize Property ....................................................................... 57

Parameters Property ....................................................................................... 58

Settings Property ............................................................................................ 58

UserState Property ......................................................................................... 59

Events .................................................................................................................. 59

UploadCompleted Event ................................................................................. 60

UploadProgressChanged Event ....................................................................... 61

C1UploaderPost ...................................................................................................... 62

Overview ............................................................................................................. 63

Members ............................................................................................................. 63

C1UploaderPost Constructor .............................................................................. 65

C1UploaderPost Constructor(Uri) ................................................................... 66

C1UploaderPost Constructor(FilesPerRequest) .............................................. 67

C1UploaderPost Constructor(UploadManagerSettingsPost) ......................... 68

C1UploaderPost Constructor(UploadManagerSettingsPost,FilePackager) .... 68

Properties ............................................................................................................ 69


Events .................................................................................................................. 70

MIMETypeRequested Event ........................................................................... 71

C1UploaderWebService .......................................................................................... 72

Overview ............................................................................................................. 72

Members ............................................................................................................. 73

C1UploaderWebService Constructor .................................................................. 75

C1UploaderWebService Constructor(Uri) ....................................................... 76

C1UploaderWebService Constructor(FilesPerRequest) .................................. 77

3

C1UploaderWebService Constructor(UploadManagerSettingsWebService) . 77

C1UploaderWebService

Constructor(UploadManagerSettingsWebService,FilePackager) ................... 78

Properties ............................................................................................................ 79


FilePackager ............................................................................................................ 80

Overview ............................................................................................................. 81

Members ............................................................................................................. 82

Methods .............................................................................................................. 83

GetMaxSizePerUpload Method ...................................................................... 83

GetPackages Method ...................................................................................... 84

GetTotalSize Method ...................................................................................... 84

Properties ............................................................................................................ 85

Files Property .................................................................................................. 85

MaximumUploadSize Property ....................................................................... 86

FilePackagerFactory ................................................................................................ 86

Overview ............................................................................................................. 87

Members ............................................................................................................. 88

Methods .............................................................................................................. 88

Create Method ................................................................................................ 88

FilePackagerMultiFile .............................................................................................. 89

Overview ............................................................................................................. 90

Members ............................................................................................................. 91

FilePackagerMultiFile Constructor ...................................................................... 92

Methods .............................................................................................................. 92



FilePackagerPartialFile ............................................................................................ 94

Overview ............................................................................................................. 95

Members ............................................................................................................. 95

FilePackagerPartialFile Constructor .................................................................... 96

Methods .............................................................................................................. 97



FilePackagerSingleFile ............................................................................................. 99

Overview ............................................................................................................. 99

4

Members ........................................................................................................... 100

FilePackagerSingleFile Constructor ................................................................... 101

Methods ............................................................................................................ 101

GetMaxSizePerUpload Method .................................................................... 102

GetPackages Method .................................................................................... 103

InvalidAddressException ....................................................................................... 103

Overview ........................................................................................................... 104

Members ........................................................................................................... 105

InvalidAddressException Constructor ............................................................... 106

InvalidAddressException Constructor() ........................................................ 106

InvalidAddressException Constructor(Exception) ........................................ 107

MaximumUploadSizeExceededException ............................................................. 108

Overview ........................................................................................................... 108

Members ........................................................................................................... 109

MaximumUploadSizeExceededException Constructor..................................... 110

MIMETypeRequestedEventArgs ........................................................................... 111

Overview ........................................................................................................... 112

Members ........................................................................................................... 112

Properties .......................................................................................................... 113

FileExtension Property .................................................................................. 113

UploadCompletedEventArgs ................................................................................. 114

Overview ........................................................................................................... 114

Members ........................................................................................................... 115

UploadCompletedEventArgs Constructor ......................................................... 116

Properties .......................................................................................................... 118

Files Property ................................................................................................ 118

Response Property ........................................................................................ 119

Success Property ........................................................................................... 119

UploadFileInfo ....................................................................................................... 120

Overview ........................................................................................................... 120

Members ........................................................................................................... 121

UploadFileInfo Constructor ............................................................................... 122

UploadFileInfo Constructor(FileInfo) ............................................................ 122

UploadFileInfo Constructor(String) ............................................................... 123

UploadFileInfo Constructor(String,Stream) .................................................. 124

Methods ............................................................................................................ 125

5

Close Method ................................................................................................ 125

GetSize Method ............................................................................................ 126

Prepare Method ............................................................................................ 126

Properties .......................................................................................................... 127

File Property .................................................................................................. 127

Name Property .............................................................................................. 128

UploadFilePartInfo ................................................................................................ 128

Overview ........................................................................................................... 129

Members ........................................................................................................... 130

UploadFilePartInfo Constructor ........................................................................ 131

UploadFilePartInfo Constructor(String,Byte[],Int32,Int32) .......................... 131

UploadFilePartInfo Constructor(UploadFileInfo) .......................................... 132

Methods ............................................................................................................ 133

GetSize Method ............................................................................................ 133

Properties .......................................................................................................... 134

Data Property ................................................................................................ 134

Name Property .............................................................................................. 135

PartCount Property ....................................................................................... 135

PartNumber Property ................................................................................... 136

UploadFilePartPackage ......................................................................................... 136

Overview ........................................................................................................... 137

Members ........................................................................................................... 138

UploadFilePartPackage Constructor ................................................................. 141

Methods ............................................................................................................ 142

GetSize Method ............................................................................................ 145

Properties .......................................................................................................... 145

ServerWaitForOneFile Property .................................................................... 146

UploadManagerPost ............................................................................................. 146

Overview ........................................................................................................... 147

Members ........................................................................................................... 147

UploadManagerPost Constructor ..................................................................... 148

Methods ............................................................................................................ 149

BeginUpload Method .................................................................................... 149

Cancel Method .............................................................................................. 150

Events ................................................................................................................ 151

UploadCompleted Event ............................................................................... 151

6

UploadProgressChanged Event ..................................................................... 152

UploadManagerSettings ....................................................................................... 153

Overview ........................................................................................................... 154

Members ........................................................................................................... 155

Properties .......................................................................................................... 155

Address Property .......................................................................................... 155

UploadManagerSettingsPost ................................................................................ 156

Overview ........................................................................................................... 157

Members ........................................................................................................... 157

UploadManagerSettingsPost Constructor ........................................................ 158

UploadManagerSettingsPost Constructor(Uri) ............................................. 159

UploadManagerSettingsPost Constructor() .................................................. 159

Properties .......................................................................................................... 160

Boundary Property ........................................................................................ 160

TransferEncoding Property ........................................................................... 161

UploadManagerSettingsWebService .................................................................... 161

Overview ........................................................................................................... 162

Members ........................................................................................................... 163

UploadManagerSettingsWebService Constructor ............................................ 164

UploadManagerSettingsWebService Constructor(Uri) ................................. 165

UploadManagerSettingsWebService Constructor() ...................................... 165

Properties .......................................................................................................... 166

MethodManyFiles Property .......................................................................... 167

MethodOneFile Property .............................................................................. 167

Namespace Property .................................................................................... 168

ParamFileData Property ................................................................................ 168

ParamFileName Property .............................................................................. 169

ParamFiles Property ...................................................................................... 169

ParamParameters Property .......................................................................... 170

ParamPartCount Property ............................................................................ 171

ParamPartNumber Property ......................................................................... 171

UploadManagerWebService ................................................................................. 172

Overview ........................................................................................................... 173

Members ........................................................................................................... 173

UploadManagerWebService Constructor ......................................................... 174

Methods ............................................................................................................ 175

7


Cancel Method .............................................................................................. 176

Events ................................................................................................................ 177



UploadProgressChangedEventArgs ...................................................................... 179

Overview ........................................................................................................... 180

Members ........................................................................................................... 180

UploadProgressChangedEventArgs Constructor .............................................. 181

Properties .......................................................................................................... 182

BytesUploaded Property ............................................................................... 183

ProgressPercentage Property ....................................................................... 183

TotalBytesToUpload Property ....................................................................... 184

UserState Property ....................................................................................... 184

Enumerations ............................................................................................................ 185

FilesPerRequest ..................................................................................................... 185

MultipartPostEncoding ......................................................................................... 186

Interfaces .................................................................................................................. 186

IUploadManager ................................................................................................... 186

Overview ........................................................................................................... 187

Members ........................................................................................................... 188

Methods ............................................................................................................ 188


Cancel Method .............................................................................................. 190

Events ................................................................................................................ 190



Delegates .................................................................................................................. 193

C1UploaderPost.MIMETypeRequestedEventHandler .......................................... 193

8

Uploader for Silverlight Upload files to the server from your Silverlight applications with Uploader for Silverlight.

Uploader for Silverlight provides a simple and reliable way to upload files and streams to the

server.

See Also

Help with ComponentOne Studio Silverlight Edition

Help with ComponentOne Studio

Silverlight Edition Uploader for Silverlight > Help with ComponentOne Studio Silverlight Edition

Getting Started

For information on installing ComponentOne Studio Silverlight Edition, licensing, technical

support, namespaces and creating a project with the control, please visit Getting Started with

Silverlight Edition.

See Also

Uploader for Silverlight Key Features

Uploader for Silverlight Key Features Uploader for Silverlight includes several key features, such as:

File Size Limitation

Set the maximum file size for file upload requests. See Maximum Upload Size for more

information.

Asynchronous File Upload

The end-user can select multiple files at a time using the FilePicker for Silverlight

control, and the C1Uploader control loads the files asynchronously.

Use Multipart Post Messages

The C1UploaderPost object enables you to upload files to the server using multipart

post messages.

Use Web Services

Use the C1UploaderWebService object to upload files to the server using Web services.

Upload Large Files

You can upload large files without changing any server configurations. Uploader for

Silverlight can split the stream into small pieces, and rejoin them on the server.

Upload Files from Multiple Sources

Upload content from a selected file in the end-user machine, an isolated storage file, or

any stream in memory.

http://helpcentral.componentone.com/nethelp/c1studiosilverlight/

http://helpcentral.componentone.com/nethelp/c1studiosilverlight/

http://helpcentral.componentone.com/nethelp/C1BasicWPFSL/#FilePicker%20.html

9

See Also Uploader for Silverlight Quick Start

Uploader for Silverlight Quick Start The following quick start guide is intended to get you up and running with Uploader for

Silverlight. In this quick start we create a new project in Visual Studio, add the C1Uploader

class to the application, and set up the application to upload files.

See Also

Step 1 of 4: Creating a Silverlight Application

Step 2 of 4: Adding Code to the Project

Step 3 of 4: Implementing Server Code

Step 4 of 4: Running the Application

Step 1 of 4: Creating a Silverlight

Application Uploader for Silverlight Quick Start > Step 1 of 4: Creating a Silverlight Application

In this step we begin in Visual Studio to create a Silverlight application using Uploader for

Silverlight. We create a new Silverlight project and set up the application.

To set up your project, complete the following steps:

1. In Visual Studio, select File | New | Project.

2. In the New Project dialog box, select a language in the left pane, and in the templates

list select Silverlight Application. Enter a Name for your project, for example

"QuickStart," and click OK. The New Silverlight Application dialog box appears.

3. Click OK to accept the default settings, close the New Silverlight Application dialog

box, and create your project. The MainPage.xaml file opens.

4. Right-click the project in the Solution Explorer window and select Add Reference.

5. In the Add Reference dialog box, locate and select the C1.Silverlight.dll and

C1.Silverlight.Uploader.dll assemblies and click OK to add references to your project.

6. In the XAML window of the project, place the cursor between the <Grid> and </Grid>

tags and click once.

7. Add the following XAML markup between the <Grid> and </Grid> tags in the

MainPage.xaml file:

XAML Copy Code

10

<StackPanel Orientation="Horizontal" Height="250"

HorizontalAlignment="Center">

<Button Content="Upload Photos" Height="30" VerticalAlignment="Top"

Margin="5" Click="Upload_Click" />

<ScrollViewer Width="400" Margin="5" Background="White">

<StackPanel x:Name="PicturePanel"/>

</ScrollViewer>

</StackPanel>

8. This markup creates a button and a panel. Users click the button to upload image files

to the server and the panel displays the images.

9. Right-click the QuickStartWeb application in the Solution Explorer and select New

Folder. Name the folder "Pictures." Note that if you name your project something other

than "QuickStart" you right-click MyProjectWeb where "MyProject" is the name of your

project.

This folder is used to save the uploaded images. After you create the Pictures folder,

you may need to set up its permissions so the application can save the pictures into the

folder. You may need to confirm that the network service has read and write

permissions on the folder.

What You've Accomplished

You have successfully created and set up a Silverlight application and added controls to the

page. In the next step we add code to implement the C1Uploader class.

See Also

Step 2 of 4: Adding Code to the Project

Step 2 of 4: Adding Code to the Project Uploader for Silverlight Quick Start > Step 2 of 4: Adding Code to the Project

In the last step you set up a Silverlight application, but if you run your application now, the

button and panel do nothing. In this step we continue in Visual Studio by adding code to your

project to implement the C1Uploader class.

To implement the C1Uploader class, complete the following steps:

1. Navigate to the Solution Explorer, right-click the MainPage.xaml file, and select View

Code to switch to Code view.

2. In Code view, add the following import statements to the top of the page if they are

not included:

Visual Basic Copy Code

11

Imports System.Windows.Controls

Imports System.IO

Imports System.Diagnostics

Imports C1.Silverlight

Imports C1.Silverlight.Uploader

3.

C# Copy Code

using System.Windows.Controls;

using System.IO;

using System.Diagnostics;

using C1.Silverlight;

using C1.Silverlight.Uploader;

4. Add the following event handler to the MainPage.xaml.cs file, below all of the other

methods in the MainPage class:


Private Sub Upload_Click(ByVal sender As Object, ByVal e As

RoutedEventArgs)

' Configure OpenFileDialog

Dim dlg As New OpenFileDialog()

dlg.Filter = "All|*.*|Images|*.jpg;*.png;*.gif"

dlg.FilterIndex = 2

dlg.Multiselect = True

' Show OpenFileDialog

If CBool(dlg.ShowDialog()) Then

Try

' Check that the files really are images

For Each fdi As FileInfo In dlg.Files

Dim img As New System.Windows.Media.Imaging.BitmapImage()

img.SetSource(fdi.OpenRead())

Next

Catch

12

C1MessageBox.Show("Sorry, at least one of the selected files is not

an image.",

"Upload Canceled", C1MessageBoxButton.OK,

C1MessageBoxIcon.Warning)

Exit Sub

End Try

' Create and configure uploader

Dim uri As Uri = BuildAbsoluteUri("photoUpload.ashx")

Dim uploader As C1Uploader = New C1UploaderPost(uri)

AddHandler uploader.UploadProgressChanged, AddressOf

uploader_UploadProgressChanged

AddHandler uploader.UploadCompleted, AddressOf

uploader_UploadCompleted

' Upload selected files

uploader.AddFiles(dlg.Files)

uploader.BeginUploadFiles()

End If

End Sub

5.

C# Copy Code

private void Upload_Click(object sender, RoutedEventArgs e)

{

// Configure OpenFileDialog

OpenFileDialog dlg = new OpenFileDialog();

dlg.Filter = "All|*.*|Images|*.jpg;*.png;*.gif";

dlg.FilterIndex = 2;

dlg.Multiselect = true;

// Show OpenFileDialog

if ((bool)dlg.ShowDialog())

{

try

{

// Check that the files really are images

foreach (FileInfo fdi in dlg.Files)

13

{

System.Windows.Media.Imaging.BitmapImage img = new

System.Windows.Media.Imaging.BitmapImage();

img.SetSource(fdi.OpenRead());

}

}

catch

{

C1MessageBox.Show(

"Sorry, at least one of the selected files doesn't appear to be

an image.",

"Upload Canceled", C1MessageBoxButton.OK,

C1MessageBoxIcon.Warning);

return;

}

// Create and configure uploader

Uri uri = BuildAbsoluteUri("photoUpload.ashx");

C1Uploader uploader = new C1UploaderPost(uri);

uploader.UploadProgressChanged += uploader_UploadProgressChanged;

uploader.UploadCompleted += uploader_UploadCompleted;

// Upload selected files

uploader.AddFiles(dlg.Files);

uploader.BeginUploadFiles();

}

}

6. This event handler initially displays an OpenFileDialog for the user to select files to

upload. Silverlight runs in a secure sandbox environment, and you cannot get direct

access to the file system. But the OpenFileDialog class grants access to specific files

explicitly selected by the user. You can also get access to files in the IsolatedStorage

area.

Once the files areselected, the code checks whether the files really are images. It does

this by creating BitmapImage objects and loading the files into the objects. If the file

does not contain an image, then an exception occurs and the process is aborted. This

check prevents users from uploading files of the wrong type, either by mistake or with

malicious intent. Later, we also perform a similar security check on the server.

After the files are validated, the code creates a new C1UploaderPost object. There are

two types of C1Uploader object, the C1UploaderPost and C1UploaderWebService.

The difference between the two is how files are received on the server.

C1UploaderPost uses a multipart POST protocol that is very convenient, as you can see

in the next steps.

7. Add the following event handler to your project:

14


Public Shared Function BuildAbsoluteUri(ByVal relativeUri As String) As Uri

' Get current absolute Uri; this depends on where the app is deployed

Dim uri As Uri = System.Windows.Browser.HtmlPage.Document.DocumentUri

Dim uriString As String = uri.AbsoluteUri

' Replace page name with relative service Uri

Dim ls As Integer = uriString.LastIndexOf("/"c)

uriString = uriString.Substring(0, ls + 1) + relativeUri

' Return new Uri

Return New Uri(uriString, UriKind.Absolute)

End Function

8.

C# Copy Code

public static Uri BuildAbsoluteUri(string relativeUri)

{

// Get current absolute Uri; this depends on where the app is deployed

Uri uri = System.Windows.Browser.HtmlPage.Document.DocumentUri;

string uriString = uri.AbsoluteUri;

// Replace page name with relative service Uri

int ls = uriString.LastIndexOf('/');

uriString = uriString.Substring(0, ls + 1) + relativeUri;

// Return new Uri

return new Uri(uriString, UriKind.Absolute);

}

9. The C1UploaderPost constructor requires a parameter that specifies the Uri of the

handler that processes the files on the server. Silverlight requires an absolute Uri, so the

code uses a helper method called BuildAbsoluteUri that works whether the application

is running on a development machine or on a production server.

The code also attaches event handlers to the UploadProgressChanged

and UploadCompleted events of the new C1Uploader. The code you add in the next

15

step uses the first to check the progress of the upload process, and the second to

display the files that are uploaded.

10. Add the following event handlers to your project:


Private Sub uploader_UploadProgressChanged(ByVal sender As Object, ByVal e

As C1.Silverlight.Uploader.UploadProgressChangedEventArgs)

Debug.WriteLine("uploaded {0} of {1} bytes, {2}%", e.BytesUploaded,

e.TotalBytesToUpload, e.ProgressPercentage)

End Sub

Private Sub uploader_UploadCompleted(ByVal sender As Object, ByVal e As

UploadCompletedEventArgs)

If e.Success Then

For Each fileName As String In e.Files

' Holder for picture and title

Dim picHolder As New StackPanel()

picHolder.Width = 200

' Create Image to show the picture

Dim bmp As New System.Windows.Media.Imaging.BitmapImage()

bmp.UriSource = BuildAbsoluteUri("Pictures/" & fileName)

Dim img As New Image()

img.Source = bmp

img.Margin = New Thickness(10, 10, 10, 0)

picHolder.Children.Add(img)

' Create image title

Dim tb As New TextBlock()

tb.Text = fileName

tb.FontSize = 12

tb.HorizontalAlignment = HorizontalAlignment.Center

tb.Margin = New Thickness(10, 0, 10, 10)

picHolder.Children.Add(tb)

' Add picture holder to panel

PicturePanel.Children.Add(picHolder)

Next

Else

Debug.WriteLine("Upload failed: {0}", If(e.[Error] IsNot Nothing,

e.[Error].Message, "??"))

End If

16

End Sub

11.

C# Copy Code

void uploader_UploadProgressChanged(object sender,

C1.Silverlight.Uploader.UploadProgressChangedEventArgs e)

{

Debug.WriteLine("uploaded {0} of {1} bytes, {2}%",

e.BytesUploaded,

e.TotalBytesToUpload,

e.ProgressPercentage);

}

void uploader_UploadCompleted(object sender, UploadCompletedEventArgs e)

{

if (e.Success)

{

foreach (string fileName in e.Files)

{

// Holder for picture and title

StackPanel picHolder = new StackPanel();

picHolder.Background = new SolidColorBrush(Colors.LightGray);

picHolder.Margin = new Thickness(10);

picHolder.Width = 200;

// Create Image to show the picture

System.Windows.Media.Imaging.BitmapImage bmp = new

System.Windows.Media.Imaging.BitmapImage();

bmp.UriSource = BuildAbsoluteUri("Pictures/" + fileName);

Image img = new Image();

img.Source = bmp;

img.Margin = new Thickness(10, 10, 10, 0);

picHolder.Children.Add(img);

// Create image title

TextBlock tb = new TextBlock();

tb.Text = fileName;

tb.FontSize = 12;

tb.HorizontalAlignment = HorizontalAlignment.Center;

17

tb.Margin = new Thickness(10, 0, 10, 10);

picHolder.Children.Add(tb);

// Add picture holder to panel

PicturePanel.Children.Add(picHolder);

}

}

else

{

Debug.WriteLine("Upload failed: {0}", e.Error != null ?

e.Error.Message : "??");

}

}

12. This code checks whether the upload is successful, and then loops through the files to

create a new Image element for each one. The Image elements are configured to show

the images, assuming they are stored under a "Pictures" folder on the server.


You've successfully created a Silverlight application and added controls to the page. If you run

the project now and try to upload some pictures, you get an error. That is because the

C1Uploader is sending files to the server, but you have not implemented the server code yet. In

the next step we implement the server code.

See Also

Step 3 of 4: Implementing Server Code

Step 3 of 4: Implementing Server Code Uploader for Silverlight Quick Start > Step 3 of 4: Implementing Server Code

In the last steps, you set up a Silverlight application and added code to your application to

implement the client action and behavior, but if you run your application now, you get an error

because the server code is not implemented. In this step we add code to your project to

implement the server code.

To implement the server code, complete the following steps:

1. In the Visual Studio Solution Explorer, right-click the QuickStartWeb solution and

select the Add | New Item option. If you named your project something other than

"QuickStart," right-click MyProjectWeb where "MyProject" is the name of your project.

2. In the Add New Item dialog box, select the Generic Handler template and name the

new class "photoUpload.ashx" (this is the Uri from the C1Uploader object in Step 2 of

4).

3. Click Add to add the file to your project and close the Add New Item dialog box.

18

4. Open the photoUpload.ashx file and replace the default implementation of the

ProcessRequest method with the following code:


Sub ProcessRequest(ByVal context As HttpContext) Implements

IHttpHandler.ProcessRequest

Const MAXFILES As Integer = 30

' Clean up

Dim path As String = context.Request.MapPath("Pictures")

Dim files As String() = System.IO.Directory.GetFiles(path)

If files.Length >= MAXFILES Then

For Each fileName As String In files

System.IO.File.Delete(fileName)

Next

End If

' Get files being uploaded

Dim i As Integer = 0

While i < context.Request.Files.Count AndAlso i < MAXFILES

Dim file As HttpPostedFile = context.Request.Files(i)

Try

' Check that it really is an image by loading it into an Image

object

Dim img As System.Drawing.Image =

System.Drawing.Image.FromStream(file.InputStream)

' Save file to the Pictures folder

Dim fileName As String = context.Request.MapPath("Pictures/" &

file.FileName)

file.SaveAs(fileName)

Catch

' If it doesn't look like a valid image, skip request

Exit Try

End Try

i += 1

End While

End Sub

19

5.

C# Copy Code

public void ProcessRequest(HttpContext context)

{

const int MAXFILES = 30;

// Clean up

string path = context.Request.MapPath("Pictures");

string[] files = System.IO.Directory.GetFiles(path);

if (files.Length >= MAXFILES)

{

foreach (string fileName in files)

System.IO.File.Delete(fileName);

}

// Get files being uploaded

for (int i = 0; i < context.Request.Files.Count && i < MAXFILES; i++)

{

HttpPostedFile file = context.Request.Files[i];

try

{

// Check that it really is an image by loading it into an

Image object

System.Drawing.Image img =

System.Drawing.Image.FromStream(file.InputStream);

// Save file to the Pictures folder

string fileName = context.Request.MapPath("Pictures/" +

file.FileName);

file.SaveAs(fileName);

}

catch

{

// If it doesn't look like a valid image, skip request

break;

}

}

}

20

6. This code starts by cleaning up the images folder in case there are more than 30 images

in it. In a real application you might do this differently, possibly by compressing old

images or enforcing a per-user storage limit.

After the clean-up, the code loops through the files in the context.Request.Files

collection and checks that they really are image files. You already added a similar check

when implementing the server part of the code, but it is important to protect both ends

of the application. Finally, the code saves each image into the Pictures folder.


You've successfully created a Silverlight application that uses the C1Uploader control to upload

files to the server. In the next step we run the application and observe its run time interactions.

See Also

Step 4 of 4: Running the Application

Step 4 of 4: Running the Application Uploader for Silverlight Quick Start > Step 4 of 4: Running the Application

Now that you have created a Silverlight application and added code to implement

the C1Uploader class, the only thing left to do is run your application. To observe your

application's run-time interactions, complete the following steps:

1. Choose Debug | Start Debugging from the menu to run your application. The

application appears with the button and panel visible.

2. Click the Upload Photos button. Observe that the Open dialog box opens and initially

only images are visible in the dialog box.

3. Locate and select a .png or .jpg file and click Open to close the dialog box. Observe

that the image you selected is now visible in the panel. The image is uploaded to the

server, saved in the Pictures folder, then downloaded back to the client by way of the

Image elements that you created in response to the UploadCompleted event.

4. Click the Upload Photos button and click All in the drop-down box next to the File

name box so all files are visible.

5. Choose a non-image file, for example a text file, and click Open. A message appears

indicating that the non-image file cannot be uploaded. This message box was specified

in the code in the previous steps.

6. Click OK to close the message box.

7. Click the Upload Photos button. In the Open dialog box, choose multiple images (click

CTRL as you click each image) and click Open. Observe that you can add multiple

images to the panel at once.


Congratulations! You've successfully completed the Uploader for Silverlight quick start and

created a basic uploading application where image files are uploaded to the server, saved in a

folder, and downloaded back to the client. You created a Silverlight application, added code to

the application, implemented the server code, and ran the application to observe run time

interactions.

21

See Also

Working with Uploader for Silverlight

Working with Uploader for Silverlight Uploader for Silverlight provides a simple and reliable way to upload files and stream to the

server using the C1Uploader component. You can easily access and implement C1Uploader

using code.

See Also

Basic Properties

Basic Methods

Basic Events

Uploading Files

Silverlight and Local Files

Maximum Upload Size

Parameters

Basic Properties Working with Uploader for Silverlight > Basic Properties

Uploader for Silverlight includes several properties that allow you to set the functionality of

the control. Some of the more important properties are listed below.

The following properties let you customize the C1Uploader control:

Property Description

Files Gets the collection of files that will be uploaded.

Headers Gets the headers that will be sent to the server with each upload.

IsBusy Gets whether the component is currently uploading files.

MaximumUploadSize Gets or sets the maximum size in bytes allowed for each upload.

See Maximum Upload Size for more information.

Parameters Gets the parameters that will be sent to the server with each upload.

22


Settings Gets the UploadManagerSettings that will be used to configure

the C1Uploader.

UserState Gets or sets an arbitrary object that will be passed to

the UploadCompleted and UploadProgressChanged events.

See Also

Basic Methods

Basic Methods Working with Uploader for Silverlight > Basic Methods

Uploader for Silverlight includes several methods that allow you to determine what and when

files should be uploaded the control. Some of the more important methods are listed below.

The following methods let you customize the C1Uploader control:

Method Description

AddFile Adds a file to the Files collection that will be sent to the server when

the BeginUploadFiles method is invoked.

AddFiles Adds a collection of files to the Files collection that will be sent to the

server when the BeginUploadFiles method is invoked.

BeginUploadFiles Begins uploading the files specified in the Files property.

Cancel Cancels the current upload process.

See Also

Basic Events

Basic Events Working with Uploader for Silverlight > Basic Events

Uploader for Silverlight includes several events that allow you to set interaction and

customize the control. Some of the more important events are listed below.

The following events let you customize the C1Uploader control:

23

Event Description

UploadCompleted Event raised when the upload has completed.

UploadProgressChanged Event that fires when the upload process makes progress.

See Also

Uploading Files

Uploading Files Working with Uploader for Silverlight > Uploading Files

The Files collection determines what files are uploaded to the server. You can add single or

multiple files to the Files collection. To add a single file to the collection, use the AddFile

method. To add multiple files use the AddFiles method. For example, you might include a

C1FilePicker control on the page and a button. When the user presses the button, the AddFile

method adds the chosen file to the Files collection.

Once you select a file or multiple files, you can use the BeginUploadFiles method to begin

uploading files to the server. When the BeginUploadFiles method is invoked, the C1Uploader

control sends files included in the Files collection to the server. If for any reason you need to

cancel the upload operation, you can invoke the Cancel method. For example, you might cancel

the operation if it takes too much time or if another operation is already in progress when the

user chooses to upload another file.

See Also

Silverlight and Local Files

Silverlight and Local Files Working with Uploader for Silverlight > Silverlight and Local Files

Silverlight limits the way that local files can be accessed on a user's machine. For security

reasons, Silverlight cannot access local files directly or access information about a user's file

system. Because of these security issues, the C1Uploader class gets access to the file stream to

upload a file using the Silverlight OpenFileDialog class.

The OpenFileDialog class returns a stream to selected files and does not give any information

about the user's file system. The OpenFileDialog class enables users to select one or more files

on the local computer or on a networked computer. Users are prompted with a dialog box

allowing them to grant access to selected files which are exposed only as file streams, similar to

isolated storage. You can use the OpenFileDialog class along with the C1Uploader class to

allow users to upload local files to the server.

http://msdn.microsoft.com/en-us/library/system.windows.controls.openfiledialog(VS.95).aspx

24

See Also

Maximum Upload Size

Maximum Upload Size Working with Uploader for Silverlight > Maximum Upload Size

You can use the C1Uploader.MaximumUploadSize property to set the maximum file size that a

user can upload to the server per upload request. Set the MaximumUploadSize property to

the maximum size per request allowed by your server. (If you are using ASP.NET, the default is

4MB.)

You can upload files larger than this size if you have C1Uploader split the file into pieces, each

of which is smaller than or equal to the MaximumUploadSize.

By default, there is no maximum upload file size, and users can upload files as large as they like,

but it can be useful to limit the size of file chunks. Large files take more time to upload, which

can cause issues where files take too long to upload or uploads time out.

To resolve these issues, configure C1Uploader to use SplitFilesIntoMultipleRequests mode.

C1Uploader splits the file into multiple requests and the MaximumUploadSize property

specifies the size of each request.

See Also

Parameters

Parameters Working with Uploader for Silverlight > Parameters

Use the Parameters property to send custom parameters from the client to the server if you

want to keep information associated with each uploaded file. For example, if you use

C1Uploader to allow users to upload music or video files, you can request information about

each file from the user to populate a database. For a music file you might request metadata that

includes the artist, title, and description.

Use the following code to set a parameter:


uploader1.Parameters("Company") = "ComponentOne"

C# Copy Code

25

uploader1.Parameters["Company"] = "ComponentOne";

This adds a "Company" parameter to the uploaded file.

See Also

Uploader for Silverlight Task-Based Help

Uploader for Silverlight Samples Uploader for Silverlight includes several C# samples. By default, samples are installed in the

Documents folder in the ComponentOne Samples\Silverlight folder. The following samples

are included:

Sample Description

C1Uploader_Demo This sample demonstrates how to use the C1Uploader component. The

sample uploads files and shows the files uploaded in the server. By

default, the C1Uploader_Demo sample is installed in the

C1.Silverlight.Schedule\C1Uploader_Demo folder in the samples

directory.

UploadFiles This sample demonstrates how to use the C1Uploader component and

shows how to configure several options in the C1Uploader control. The

sample shows a step-by-step diagram of how to select files, configure

C1Uploader, call the BeginUploadFiles method, and handle the requests

on the server. By default, the UploadFiles sample is installed in the

C1.Silverlight.Schedule\UploadFiles folder in the samples directory.

Uploader for Silverlight Task-Based

Help The following task-based help topics assume that you are familiar with Visual Studio and

Expression Blend and know how to use the C1Uploader control in general. If you are unfamiliar

with the Uploader for Silverlight product, please see the Uploader for Silverlight Quick Start

first.

Each topic in this section provides a solution for specific tasks using the Uploader for

Silverlight product. Most task-based help topics also assume that you have created a new

Silverlight project.

26

See Also

Splitting Files

Cancelling a File Upload

Determining whether C1Uploader is Busy

Compressing and Uploading Files

Uploading and Previewing Files

Splitting Files Uploader for Silverlight Task-Based Help > Splitting Files

Large files take more time to upload, and you may have issues where files take too long to

upload or uploads time out. You can resolve these issues by configuring C1Uploader

to SplitFilesIntoMultipleRequests mode. C1Uploader splits the file into multiple requests and

the MaximumUploadSize property specifies the size of each request.

For example, use the following code to create a new C1Uploader control that splits uploaded

files into multiple requests:


Dim uploader1 As New

C1UploaderPost(FilesPerRequest.SplitFilesIntoMultipleRequests)

C# Copy Code

C1UploaderPost uploader1 = new

C1UploaderPost(FilesPerRequest.SplitFilesIntoMultipleRequests);

C1Uploader splits uploaded files into multiple requests. Note that you can set the

MaximumUploadSize property to specify the size of each request.

See Also

Cancelling a File Upload

27

Cancelling a File Upload Uploader for Silverlight Task-Based Help > Cancelling a File Upload

You may run into the need to cancel a file upload. You can use the Cancel method to cancel file

uploads. For example, you can cancel the upload if it is taking too long or using too many

resources.

For example, you might use the following code to cancel an upload:


uploader1.Cancel()

C# Copy Code

uploader1.Cancel();

This cancels the C1Uploader control's current upload process.

See Also

Determining whether C1Uploader is Busy

Determining whether C1Uploader is Busy Uploader for Silverlight Task-Based Help > Determining whether C1Uploader is Busy

Within your application, you may want to determine whether the C1Uploader control is

currently busy. You can determine whether a file is being uploaded or if C1Uploader has

finished uploading files. To do so, use the IsBusy property. The code below determines whether

the C1Uploader control is currently busy, and if not, uploads a new file.

To determine whether the uploader is busy:


If uploader.IsBusy = False Then

uploader.AddFile("test.pdf", stream)


End If

28

C# Copy Code

if (uploader.IsBusy == false)

{

uploader.AddFile("test.pdf", stream);


}

See Also

Compressing and Uploading Files

Compressing and Uploading Files Uploader for Silverlight Task-Based Help > Compressing and Uploading Files

You may want to compress files before uploading them to the server. To do so, you can use the

C1Zip class included with Silverlight Edition along with the C1Uploader class. In this topic we

create an application to zip and upload files.

Complete the following steps to create the UI:

1. In Visual Studio 2008, select File | New | Project.


list, select Silverlight Application. Enter a Name for your project and click OK. The

New Silverlight Application dialog box appears.

3. Click OK to accept default settings, close the New Silverlight Application dialog box,

and create your project. The MainPage.xaml file opens.

4. In the Solution Explorer window, right-click the project and select Add Reference.

5. In the Add Reference dialog box, locate and select the C1.Silverlight.Zip.dll and


6. Place the cursor in the XAML window of the project, and delete the <Grid> and

</Grid> tags. We replace these tags in the next step.

7. In the MainPage.xaml file, between the <UserControl> and </UserControl> tags, add

the following XAML markup:

XAML Copy Code

<StackPanel Orientation="Horizontal" x:Name="LayoutRoot" Background="White"

HorizontalAlignment="Center" VerticalAlignment="Center"

MinHeight="400">

29

<Border Padding="5" BorderBrush="Black" BorderThickness="1" Margin="2"

MinWidth="200">

<StackPanel>

<Button Content="Open files" Click="OpenFiles" />

<TextBlock Text="Opened files:" FontWeight="Bold" Margin="10"/>

<ItemsControl Name="files"/>

</StackPanel>

</Border>

<Button Content="Zip and upload files >" Grid.Column="1"

VerticalAlignment="Center" Margin="10" Click="ZipAndUpload"

Name="zipAndUploladButton"/>

<Border Padding="5" BorderBrush="Black" BorderThickness="1" Margin="2"

Grid.Column="2">

<StackPanel>

<TextBlock Text="Zipped files on the server:" FontWeight="Bold"

Margin="10"/>

<ItemsControl Name="zips" Background="White"/>

</StackPanel>

</Border>

</StackPanel>

8. This markup creates panels and a button that users click to zip and upload files to the

server.

Complete the following steps to add event handling to your project:

1. In the Solution Explorer, right-click the MyProjectWeb application where "MyProject" is

the name of your project application. Select New Folder and name the folder "Zips."

This folder contains the compressed files.

2. In the Solution Explorer, right-click MainPage.xaml file and select View Code to switch

to Code view.


not included:


Imports System.IO

Imports C1.C1Zip


4.

30

C# Copy Code

using System.IO;

using C1.C1Zip;


5. Define the following variables just inside the MainPage class:


Dim fileInfos As IEnumerable(Of FileInfo)

Dim zipCount As Integer = 0

6.

C# Copy Code

IEnumerable<FileInfo> fileInfos;

int zipCount = 0;

7. Below all the other methods in the MainPage class, add the following event handler to

the MainPage.xaml.cs file:


Private Sub OpenFiles(ByVal sender As Object, ByVal e As RoutedEventArgs)

Dim dialog = New OpenFileDialog()

dialog.ShowDialog()

If dialog.Files Is Nothing Then

Exit Sub

End If

fileInfos = dialog.Files

files.ItemsSource = fileInfos.[Select](Function(fi) fi.Name)

zipAndUploladButton.IsEnabled = fileInfos.Any()

End Sub

31

8.

C# Copy Code

private void OpenFiles(object sender, RoutedEventArgs e)

{

var dialog = new OpenFileDialog { Multiselect = true };

dialog.ShowDialog();

if (dialog.Files == null)

{

return;

}

fileInfos = dialog.Files;

files.ItemsSource = fileInfos.Select(fi => fi.Name);

zipAndUploladButton.IsEnabled = fileInfos.Any();

}

9. This event handler initially displays an OpenFileDialog for the user to select files to

upload.

10. Add the following event handler to your project to zip and upload files:


Private Sub ZipAndUpload(ByVal sender As Object, ByVal e As

RoutedEventArgs)

' create memory stream and zip file

Dim stream = New MemoryStream()

' set MemoryThreshold to prevent C1ZipFile from trying to use a

temporary file

Dim zip = New C1ZipFile(stream, True)

' add files to zip

For Each fileInfo In fileInfos

Dim fileStream = fileInfo.OpenRead()

zip.Entries.Add(fileStream, fileInfo.Name)

fileStream.Close()

Next

32

' create uploader

Dim uploader As C1Uploader = New

C1UploaderPost(BuildAbsoluteUri("Upload.ashx"))

' set the stream at the beginning and add it to the uploader

stream.Seek(0, SeekOrigin.Begin)

Dim zipName = System.Threading.Interlocked.Increment(zipCount) & ".zip"

uploader.AddFile(zipName, stream)

' when the upload is complete show it on the zips list

Dim hb As New HyperlinkButton

hb.Content = zipName

hb.NavigateUri = BuildAbsoluteUri("Zips/" + zipName)

If uploader.IsBusy = False Then

Me.zips.Items.Add(hb)

End If

' upload zip file!


End Sub

11.

C# Copy Code

private void ZipAndUpload(object sender, RoutedEventArgs e)

{

// create memory stream and zip file

var stream = new MemoryStream();

var zip = new C1ZipFile(stream, true)

{

// set MemoryThreshold to prevent C1ZipFile from trying to use a

temporary file

MemoryThreshold = int.MaxValue,

CompressionLevel = CompressionLevelEnum.BestCompression

};

// add files to zip

foreach (var fileInfo in fileInfos)

{

33

var fileStream = fileInfo.OpenRead();

zip.Entries.Add(fileStream, fileInfo.Name);

fileStream.Close();

}

// create uploader

C1Uploader uploader = new

C1UploaderPost(BuildAbsoluteUri("Upload.ashx"));

// set the stream at the beginning and add it to the uploader

stream.Seek(0, SeekOrigin.Begin);

var zipName = ++zipCount + ".zip";

uploader.AddFile(zipName, stream);

// when the upload is complete show it on the zips list

uploader.UploadCompleted += (s, e2) =>

{

zips.Items.Add(new HyperlinkButton

{

Content = zipName,

NavigateUri = BuildAbsoluteUri("Zips/" + zipName)

});

};

// upload zip file!


}

12. Add the following event handler to your project:


Public Shared Function BuildAbsoluteUri(ByVal relativeUri As String) As Uri

' Get current absolute Uri; this depends on where the app is deployed

Dim uri As Uri = System.Windows.Browser.HtmlPage.Document.DocumentUri

Dim uriString As String = uri.AbsoluteUri

' Replace page name with relative service Uri

Dim ls As Integer = uriString.LastIndexOf("/"c)

uriString = uriString.Substring(0, ls + 1) + relativeUri

34

' Return new Uri

Return New Uri(uriString, UriKind.Absolute)

End Function

13.

C# Copy Code

public static Uri BuildAbsoluteUri(string relativeUri)

{

// Get current absolute Uri; this depends on where the app is deployed

Uri uri = System.Windows.Browser.HtmlPage.Document.DocumentUri;

string uriString = uri.AbsoluteUri;

// Replace page name with relative service Uri

int ls = uriString.LastIndexOf('/');

uriString = uriString.Substring(0, ls + 1) + relativeUri;

// Return new Uri

return new Uri(uriString, UriKind.Absolute);

}

Complete the following steps to add a method to clean up and add files to the zip file:

1. In the Visual Studio Solution Explorer, right-click the MyProjectWeb solution where

"MyProject" is the name of your project. Select the Add | New Item option.


new class "Upload.ashx" (this is the Uri from the C1Uploader object).


4. Open the Upload.ashx code file and add the following import statement to the top of

the page if it is not included:


Imports System.Web.Services

5.

35

C# Copy Code

using System.Web.Services;

6. Replace the default implementation of the ProcessRequest method with the following

code:




Const MAXFILES As Integer = 30

' Clean up

Dim path As String = context.Request.MapPath("Zips")

Dim files As String() = System.IO.Directory.GetFiles(path)

If files.Length >= MAXFILES Then

For Each fileName As String In files

System.IO.File.Delete(fileName)

Next

End If

' Get files being uploaded

Dim i As Integer = 0

While i < context.Request.Files.Count AndAlso i < MAXFILES


' Save file to the Zips folder

Dim fileName As String = context.Request.MapPath("Zips/" &

file.FileName)

file.SaveAs(fileName)

i += 1

End While

End Sub

7.

36

C# Copy Code


{

const int MAXFILES = 30;

// Clean up

string path = context.Request.MapPath("Zips");

string[] files = System.IO.Directory.GetFiles(path);

if (files.Length >= MAXFILES)

{

foreach (string fileName in files)

System.IO.File.Delete(fileName);

}

// Get files being uploaded

for (int i = 0; i < context.Request.Files.Count && i < MAXFILES; i++)

{


// Save file to the Zips folder

string fileName = context.Request.MapPath("Zips/" + file.FileName);

file.SaveAs(fileName);

}

}

}

8. This code starts by cleaning up the zips folder in case there are more than 30 files in it.

After the clean-up, the code loops through the files in the context.Request.Files

collection and saves each file into the Zips folder.


You've successfully created a Silverlight application that uploads zipped files. To observe how

the application works, complete the following steps:

1. To run the application, select Debug | Start Debugging.

2. Click the Open files button to choose files to upload.

3. In the Open dialog box, select a file or multiple files to upload, and click the Open

button. The dialog box closes.

4. Click the Zip and upload files button to upload the selected files.

5. A link to the zipped file appears. (The name is "1.zip" if it is the first file uploaded.)

6. Click on the link to the zip file and save it to your computer.

7. Extract the zip file and observe that the items you uploaded exist in the file.

37

See Also

Uploading and Previewing Files

Uploading and Previewing Files Uploader for Silverlight Task-Based Help > Uploading and Previewing Files

You can use Uploader for Silverlight in combination with PDF for Silverlight to create and

upload PDF files to the server. In this topic we use the C1Uploader class along with C1Pdf to

create PDF files uploaded to a stream so a user can preview files to print. Note that for

simplicity the project uses the C1UploaderHelper.cs code file included with the Uploader for

Silverlight samples.

Complete the following steps to create the project:

1. In Visual Studio 2008, select File | New | Project.


list select Silverlight Application. Enter a Name for your project and click OK. The

New Silverlight Application dialog box appears.

3. Click OK to accept default settings, close the New Silverlight Application dialog box,

and create your project. The MainPage.xaml file opens.

4. Right-click the project in the Solution Explorer window and select Add Reference.

5. In the Add Reference dialog box, locate and select the C1.Silverlight.Pdf.dll and


6. in the MainPage.xaml file, between the <Grid> and </Grid> tags, add the following

XAML markup:

XAML Copy Code

<StackPanel Width="300" HorizontalAlignment="Center"

VerticalAlignment="Center">

<TextBlock Text="Enter text here:" Margin="10"/>

<TextBox Name="tb" Margin="10" Height="100" TextWrapping="Wrap"/>

<Button Content="Print and Open PDF" Margin="10" Click="Button_Click"

/>

</StackPanel>

7. This markup creates a text box to enter text to include in the PDF and a button for

users to click to turn the text into a PDF and upload the file to the server.

8. In the Solution Explorer, right-click the MyProjectWeb application where "MyProject" is

the name of your project application. Select New Folder and name the folder "temp."

This folder contains the PDF file.

Complete the following steps to code the button click and upload methods:

38

1. In the Solution Explorer, right-click MainPage.xaml file and select View Code to switch

to Code view.


not included:


Imports System.IO

Imports C1.Silverlight.Pdf


3.

C# Copy Code

using System.IO;

using C1.Silverlight.Pdf;


4. Add the following code to the MainPage class:


Private Sub Button_Click(ByVal sender As Object, ByVal e As

RoutedEventArgs)

' Create PDF

Dim doc As New C1PdfDocument()

Dim st As String = Nothing

st = tb.Text

doc.DrawString(st, New Font("Arial", 14), Colors.Black, New Rect(0, 0,

500, 100))

' Generate stream

Dim stream As Stream

stream = New MemoryStream()

doc.Save(stream)

39

' Upload stream

Dim uploader = CreateUploader()

uploader.AddFile("test.pdf", stream)


AddHandler uploader.UploadCompleted, AddressOf uploader_UploadCompleted

End Sub

Private Sub uploader_UploadCompleted(ByVal sender As Object, ByVal e As


' Navigate to PDF

If e.[Error] Is Nothing Then

Dim url = New Uri(DirectCast(e.Response, String())(0))

System.Windows.Browser.HtmlPage.Window.Navigate(url)

End If

End Sub

Private Function CreateUploader() As C1Uploader

Dim mpUploader As New

C1UploaderPost(FilesPerRequest.AllFilesInOneRequest)

mpUploader.Settings.Address =

C1.Silverlight.Extensions.GetAbsoluteUri("Handler.ashx")

Return mpUploader

End Function

5.

C# Copy Code

private void Button_Click(object sender, RoutedEventArgs e)

{

// Create PDF

C1PdfDocument doc = new C1PdfDocument();

doc.DrawString(tb.Text, new Font("Arial", 12), Colors.Black, new

Rect(0, 0, 500, 100));

// Generate stream

Stream stream;

stream = new MemoryStream();

doc.Save(stream);

40

// Upload stream

var uploader = CreateUploader();

uploader.AddFile("test.pdf", stream);


uploader.UploadCompleted += new

EventHandler<UploadCompletedEventArgs>(uploader_UploadCompleted);

}

void uploader_UploadCompleted(object sender, UploadCompletedEventArgs e)

{

// Navigate to PDF

if (e.Error == null)

{

var url = new Uri(((string[])e.Response)[0]);

System.Windows.Browser.HtmlPage.Window.Navigate(url);

}

}

private C1Uploader CreateUploader()

{

C1UploaderPost mpUploader = new

C1UploaderPost(FilesPerRequest.AllFilesInOneRequest);

mpUploader.Settings.Address =

C1.Silverlight.Extensions.GetAbsoluteUri("Handler.ashx");

return mpUploader;

}

Complete the following steps to process requests:


"MyProject" is the name of your project. Select the Add | Existing Item option.

2. In the Add Existing Item dialog box, navigate to the ControlExplorerWeb folder where

samples are installed, select the C1UploaderHelper.cs file, and click the Add button.

By default the ControlExplorerWeb folder is located in the Documents or My

Documents folder at ComponentOne Samples\Studio for

Silverlight\ControlExplorer\ControlExplorerWeb.


"MyProject" is the name of your project. Select the Add | New Item option.


new class "Handler.ashx."


41

6. Open the Handler.ashx code file and add the following import statement (where

"MyProject" is the name of your project application in the Solution Explorer) to the top

of the page if it is not included:


Imports System.Web

Imports System.Web.Services

Imports MyProject

7.

C# Copy Code

using System.Web;

using System.Web.Services;

using MyProject;

8. Replace the default implementation of the ProcessRequest method with the following

code:




Try

' Get custom parameters

Dim parameters As String = context.Request.Params("parameters")

For i As Integer = 0 To context.Request.Files.Count - 1

' Get the uploaded file, and calculates the full path to save it in

the server


Dim serverFileName As String =

C1UploaderHelper.GetServerPath(context.Server, file.FileName)

If C1UploaderHelper.ProcessPart(context, file.InputStream,

serverFileName, 1, 1) Then

42

' Add the URL of the uploaded file to the response

Dim url As String =

C1UploaderHelper.GetUploadedFileUrl(context, "Handler.ashx",file.FileName)

context.Response.Write((If(i > 0, "|", String.Empty)) + url)

Else

C1UploaderHelper.WriteError(context,

C1UploaderHelper.ERROR_MESSAGE)

Exit For

End If

Next

Catch exc As Exception

C1UploaderHelper.WriteError(context, exc.Message)

context.Response.[End]()

End Try

End Sub

9.

C# Copy Code


{

try

{

// Get custom parameters

string parameters = context.Request.Params["parameters"];

for (int i = 0; i < context.Request.Files.Count; i++)

{

// Get the uploaded file, and calculates the full path to save

it in the server


string serverFileName =

C1UploaderHelper.GetServerPath(context.Server,file.FileName);

if (File.Exists(file.FileName))

File.Delete(file.FileName);

if (C1UploaderHelper.ProcessPart(context, file.InputStream,

serverFileName, 1, 1))

{

// Add the URL of the uploaded file to the response

43

string url =

C1UploaderHelper.GetUploadedFileUrl(context,"Handler.ashx", file.FileName);

context.Response.Write((i > 0 ? "|" : string.Empty) + url);

}

else

{

C1UploaderHelper.WriteError(context,

C1UploaderHelper.ERROR_MESSAGE);

break;

}

}

}

catch (Exception exc)

{

C1UploaderHelper.WriteError(context, exc.Message);

context.Response.End();

}

}


You've successfully created a Silverlight application that uploads and previews text in a PDF file.

To observe how the application works, complete the following steps:

1. To run the application, select Debug | Start Debugging.

2. Enter text in the text box, for example "Hello World!"

3. Click the Print and Open PDF button.

The text you entered is added to the test.pdf file and opened. You can close the PDF file, enter

new text in the text box, and click the button. The new text appears in the PDF file that opens.

See Also

C1.Silverlight.Uploader Namespace

44

API

C1.Silverlight.Uploader.5 Assembly

Namespaces


Overview Classes

Class Description

C1Uploader Represents an object that uploads files to a

server.

C1UploaderPost Represents a class that uploads files to the

server using multipart POST messages.

C1UploaderWebService Represents a class that uploads files to the

server using Web services.

FilePackager Represents an object that maps files into server

requests.

FilePackagerFactory Static class that creates FilePackager objects.

FilePackagerMultiFile FilePackager that packages multiple files per

request.

FilePackagerPartialFile FilePackager that breaks up files into multiple

requests.

FilePackagerSingleFile FilePackager that packages one file per request.

InvalidAddressException This exception is raised if the address of the

service to be called is not correct.

45

MaximumUploadSizeExceededException This exception is raised when the size needed to

do the upload is greater than the size specified

by the user.

MIMETypeRequestedEventArgs Provides data for the

C1UploaderPost.MIMETypeRequested event.

UploadCompletedEventArgs Contains data about upload completed event of

the upload file

UploadFileInfo Wraps the information of files that comes from

different sources.

UploadFilePartInfo Represents a file part. It can be a file or a file

segment.

UploadFilePartPackage Contains a sets of UploadFilePartInfo.

UploadManagerPost Class that packages files into multipart POST

requests.

UploadManagerSettings Contains parameters that specify the behavior of

IUploadManager objects.

UploadManagerSettingsPost Contains parameters that specify the behavior of

UploadManagerPost objects.

UploadManagerSettingsWebService Contains parameters that specify the behavior of

UploadManagerWebService objects.

UploadManagerWebService Class that packages files into Web Service

requests.

UploadProgressChangedEventArgs Contains data about progress changed event of

the upload file.

Interfaces

Interface Description

46

IUploadManager Interface implemented by classes that package files into server requests.

Delegates

Delegate Description

C1UploaderPost.MIMETypeRequestedEventHandle

r

Represents the method that will

handle the

C1UploaderPost.MIMETypeRequeste

d event.

Enumerations

Enumeration Description

FilesPerRequest Specifies how files are mapped into server requests.

MultipartPostEncoding Specifies the encoding of the data that will be sent in the post

message.

See Also

Reference

C1.Silverlight.Uploader.5 Assembly

Classes

C1Uploader Represents an object that uploads files to a server.

Object Model

Syntax

Visual Basic (Declaration)

Public MustInherit Class C1Uploader

C#

public abstract class C1Uploader

Remarks

C1.Silverlight.Uploader.5.html

47

C1Uploader is the abstract base class of C1UploaderPost, which uploads files using multipart

POST requests, and C1UploaderWebService, which uploads files using web services.

Inheritance Hierarchy

System.Object

C1.Silverlight.Uploader.C1Uploader

C1.Silverlight.Uploader.C1UploaderPost

C1.Silverlight.Uploader.C1UploaderWebService

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server

2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or

later), Windows Server 2003 SP2

See Also

Reference

C1Uploader Members


Overview Represents an object that uploads files to a server.

Object Model

Syntax


Public MustInherit Class C1Uploader

C#

public abstract class C1Uploader

Remarks

C1Uploader is the abstract base class of C1UploaderPost, which uploads files using multipart

POST requests, and C1UploaderWebService, which uploads files using web services.


System.Object




48

Requirements




See Also

Reference

C1Uploader Members


Members Properties Methods Events

The following tables list the members exposed by C1Uploader.

Public Properties

Name Description





Parameters Gets the parameters that will be sent to the server with each

upload.

Settings Gets the UploadManagerSettings that will be used to configure the

C1Uploader.

UserState Gets or sets an arbitrary object that will be passed to the

UploadCompleted and UploadProgressChanged events.

Top

Public Methods

Name Description

49

AddFile Overloaded. Adds a file to the Files collection that will be sent to the






Top

Public Events

Name Description



Top

See Also

Reference

C1Uploader Class


Methods %%scrap%%

" -->

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

Public Methods

Name Description





50



Top

See Also

Reference

C1Uploader Class


AddFile Method Adds a file to the Files collection that will be sent to the server when the BeginUploadFiles

method is invoked.

Overload List

Overload Description

AddFile(FileInfo) Adds a file to the Files collection that will be sent to the server when


AddFile(String) Adds a file to the Files collection that will be sent to the server when


AddFile(String,Stream) Adds a System.IO.Stream to the Files collection that will be sent to

the server when the BeginUploadFiles method is invoked.

Requirements




See Also

Reference

C1Uploader Class

C1Uploader Members

AddFile(FileInfo) Method

System.IO.FileInfo that identifies the file to be uploaded.

Adds a file to the Files collection that will be sent to the server when the BeginUploadFiles

method is invoked.

51

Syntax


Public Overloads Sub AddFile( _

ByVal file As System.IO.FileInfo _

)

C#

public void AddFile(

System.IO.FileInfo file

)

Parameters

file

System.IO.FileInfo that identifies the file to be uploaded.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows

Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported

with SP1 or later), Windows Server 2003 SP2

See Also

Reference

C1Uploader Class

C1Uploader Members

Overload List

AddFile(String) Method

Name of the file (in the Silverlight Isolated Storage) to be uploaded.

Adds a file to the Files collection that will be sent to the server when the BeginUploadFiles

method is invoked.

Syntax



ByVal fileName As System.String _

)

C#


52

System.string fileName

)

Parameters

fileName

Name of the file (in the Silverlight Isolated Storage) to be uploaded.

Requirements




See Also

Reference

C1Uploader Class

C1Uploader Members

Overload List

AddFile(String,Stream) Method

Name of the file as it will be seen by the server.

System.IO.Stream that contains the data to be uploaded.

Adds a System.IO.Stream to the Files collection that will be sent to the server when the

BeginUploadFiles method is invoked.

Syntax



ByVal name As System.String, _

ByVal file As System.IO.Stream _

)

C#


System.string name,

System.IO.Stream file

)

Parameters

name

Name of the file as it will be seen by the server.

53

file

System.IO.Stream that contains the data to be uploaded.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3,

Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server

Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

C1Uploader Class

C1Uploader Members

Overload List

AddFiles Method Collection of System.IO.FileInfo objects that specify the files to be uploaded.

Adds a collection of files to the Files collection that will be sent to the server when the

BeginUploadFiles method is invoked.

Syntax


Public Sub AddFiles( _

ByVal files As System.Collections.Generic.IEnumerable(Of FileInfo) _

)

C#

public void AddFiles(

System.Collections.Generic.IEnumerable<FileInfo> files

)

Parameters

files

Collection of System.IO.FileInfo objects that specify the files to be uploaded.

Requirements




See Also

54

Reference

C1Uploader Class

C1Uploader Members

BeginUploadFiles Method Begins uploading the files specified in the Files property.

Syntax


Public Function BeginUploadFiles() As System.Boolean

C#

public System.bool BeginUploadFiles()

Return Value

True if the upload started successfully, false if the C1Uploader is busy or if there are no files to

upload.

Exceptions

Exception Description

MaximumUploadSizeExceededException This exception is raised when the size needed to do

the upload is greater than the size specified by the

user.

InvalidAddressException This exception is raised if the address of the service

to be called is not correct.

Remarks

You can check the IsBusy property to determine whether the component is currently uploading

files, and use the Cancel method to cancel the current upload process.

Requirements




See Also

Reference

55

C1Uploader Class

C1Uploader Members

Cancel Method Cancels the current upload process.

Syntax


Public Function Cancel() As System.Boolean

C#

public System.bool Cancel()

Return Value

True if the current upload process has been canceled successfully.

Requirements




See Also

Reference

C1Uploader Class

C1Uploader Members

Properties >

Name Description





Parameters Gets the parameters that will be sent to the server with each upload.

Settings

Gets the UploadManagerSettings that will be used to configure the

C1Uploader.

56

UserState

Gets or sets an arbitrary object that will be passed to the

UploadCompleted and UploadProgressChanged events.

Top

See Also

Reference

C1Uploader Class


Files Property Gets the collection of files that will be uploaded.

Syntax


Public ReadOnly Property Files As System.Collections.Generic.List(Of

UploadFileInfo)

C#

public System.Collections.Generic.List<UploadFileInfo> Files {get;}

Requirements




See Also

Reference

C1Uploader Class

C1Uploader Members

Headers Property Gets the headers that will be sent to the server with each upload.

Syntax


Public ReadOnly Property Headers As

System.Collections.Generic.Dictionary(Of HttpRequestHeader,String)

C#

57

public System.Collections.Generic.Dictionary<HttpRequestHeader,string>

Headers {get;}

Requirements




See Also

Reference

C1Uploader Class

C1Uploader Members

IsBusy Property Gets whether the component is currently uploading files.

Syntax


Public ReadOnly Property IsBusy As System.Boolean

C#

public System.bool IsBusy {get;}

Requirements




See Also

Reference

C1Uploader Class

C1Uploader Members

MaximumUploadSize Property Gets or sets the maximum size in bytes allowed for each upload.

Syntax


Public Property MaximumUploadSize As System.Long

58

C#

public System.long MaximumUploadSize {get; set;}

Requirements




See Also

Reference

C1Uploader Class

C1Uploader Members

Parameters Property Gets the parameters that will be sent to the server with each upload.

Syntax


Public ReadOnly Property Parameters As

System.Collections.Generic.Dictionary(Of String,String)

C#

public System.Collections.Generic.Dictionary<string,string> Parameters

{get;}

Requirements




See Also

Reference

C1Uploader Class

C1Uploader Members

Settings Property Gets the UploadManagerSettings that will be used to configure the C1Uploader.

Syntax

59


Public Overridable ReadOnly Property Settings As UploadManagerSettings

C#

public virtual UploadManagerSettings Settings {get;}

Requirements




See Also

Reference

C1Uploader Class

C1Uploader Members

UserState Property Gets or sets an arbitrary object that will be passed to the UploadCompleted and

UploadProgressChanged events.

Syntax


Public Property UserState As System.Object

C#

public System.object UserState {get; set;}

Requirements




See Also

Reference

C1Uploader Class

C1Uploader Members

Events %%scrap%%

" -->

60

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

Public Events

Name Description



Top

See Also

Reference

C1Uploader Class


UploadCompleted Event Event raised when the upload has completed.

Syntax


Public Event UploadCompleted As System.EventHandler(Of


C#

public event System.EventHandler<UploadCompletedEventArgs> UploadCompleted

Event Data

The event handler receives an argument of type UploadCompletedEventArgs containing data

related to this event. The following UploadCompletedEventArgs properties provide

information specific to this event.


Cancelled (Inherited from System.ComponentModel.AsyncCompletedEventArgs)

Error (Inherited from System.ComponentModel.AsyncCompletedEventArgs)

Files Array of names of the files uploaded

Response Response returned by the server in the message body.

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadCompletedEventArgs~Cancelled.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadCompletedEventArgs~Error.html

61

Success True if all the files were uploaded successfully.

UserState (Inherited from System.ComponentModel.AsyncCompletedEventArgs)

Requirements




See Also

Reference

C1Uploader Class

C1Uploader Members

UploadProgressChanged Event Event that fires when the upload process makes progress.

Syntax


Public Event UploadProgressChanged As System.EventHandler(Of

UploadProgressChangedEventArgs)

C#

public event System.EventHandler<UploadProgressChangedEventArgs>

UploadProgressChanged

Event Data

The event handler receives an argument of type UploadProgressChangedEventArgs containing

data related to this event. The following UploadProgressChangedEventArgs properties

provide information specific to this event.


BytesUploaded Amount of bytes that were uploaded.

ProgressPercentage Percentage of bytes that were uploaded.

TotalBytesToUpload Amount of bytes that must be uploaded.

UserState Additional information attached by the user.

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadCompletedEventArgs~UserState.html

62

Requirements




See Also

Reference

C1Uploader Class

C1Uploader Members

C1UploaderPost Represents a class that uploads files to the server using multipart POST messages.

Object Model

Syntax


Public Class C1UploaderPost

Inherits C1Uploader

C#

public class C1UploaderPost : C1Uploader


System.Object



Requirements




See Also

Reference

C1UploaderPost Members


63

Overview Represents a class that uploads files to the server using multipart POST messages.

Object Model

Syntax


Public Class C1UploaderPost

Inherits C1Uploader

C#

public class C1UploaderPost : C1Uploader


System.Object



Requirements




See Also

Reference




The following tables list the members exposed by C1UploaderPost.

Public Constructors

Name Description

C1UploaderPost Constructor Overloaded.

Top

64

Public Properties

Name Description

Files Gets the collection of files that will be uploaded. (Inherited from

C1.Silverlight.Uploader.C1Uploader)


(Inherited from C1.Silverlight.Uploader.C1Uploader)

IsBusy Gets whether the component is currently uploading files. (Inherited

from C1.Silverlight.Uploader.C1Uploader)




upload. (Inherited from C1.Silverlight.Uploader.C1Uploader)

Settings Gets the UploadManagerSettingsPost that specifies how the upload

process should be performed.


UploadCompleted and UploadProgressChanged events. (Inherited


Top

Public Methods

Name Description


server when the BeginUploadFiles method is invoked. (Inherited from





65

BeginUploadFiles Begins uploading the files specified in the Files property. (Inherited


Cancel Cancels the current upload process. (Inherited from


Top

Public Events

Name Description

MIMETypeRequested This event will be raised for each file, to customize the Content-

Type http header.

UploadCompleted Event raised when the upload has completed. (Inherited from




Top

See Also

Reference

C1UploaderPost Class


C1UploaderPost Constructor

Overload List


C1UploaderPost Constructor(Uri) Initializes a new

instance of a

C1UploaderPost.

C1UploaderPost Constructor(FilesPerRequest) Initializes a new

instance of a

C1UploaderPost.

66

C1UploaderPost Constructor(UploadManagerSettingsPost) Initializes a new

instance of a

C1UploaderPost.

C1UploaderPost Constructor(UploadManagerSettingsPost,FilePackager) Initializes a new

instance of a

C1UploaderPost.

Requirements




See Also

Reference



C1UploaderPost Constructor(Uri) System.Uri that will receive the upload requests.

Initializes a new instance of a C1UploaderPost.

Syntax


Public Function New( _

ByVal address As System.Uri _

)

C#

public C1UploaderPost(

System.Uri address

)

Parameters

address

System.Uri that will receive the upload requests.

Requirements

67




See Also

Reference



Overload List

C1UploaderPost Constructor(FilesPerRequest) FilesPerRequest value that specifies how files should be packaged into requests.


Syntax



ByVal filePackager As FilesPerRequest _

)

C#


FilesPerRequest filePackager

)

Parameters

filePackager

FilesPerRequest value that specifies how files should be packaged into requests.

Requirements




See Also

Reference



Overload List

68

C1UploaderPost Constructor(UploadManagerSettingsPost) UploadManagerSettingsPost that specifies how the upload process will be performed.


Syntax



ByVal settings As UploadManagerSettingsPost _

)

C#


UploadManagerSettingsPost settings

)

Parameters

settings

UploadManagerSettingsPost that specifies how the upload process will be performed.

Requirements




See Also

Reference



Overload List

C1UploaderPost Constructor(UploadManagerSettingsPost,FilePackager) UploadManagerSettingsPost that specifies how the upload process will be performed.



Syntax



69

ByVal settings As UploadManagerSettingsPost, _

ByVal filePackager As FilePackager _

)

C#


UploadManagerSettingsPost settings,

FilePackager filePackager

)

Parameters

settings

UploadManagerSettingsPost that specifies how the upload process will be performed.

filePackager


Requirements




See Also

Reference



Overload List

Properties >

Name Description

Files

Gets the collection of files that will be uploaded. (Inherited from


Headers

Gets the headers that will be sent to the server with each upload.


IsBusy

Gets whether the component is currently uploading files. (Inherited


MaximumUploadSize

Gets or sets the maximum size in bytes allowed for each upload.


70

Parameters

Gets the parameters that will be sent to the server with each upload.


Settings

Gets the UploadManagerSettingsPost that specifies how the upload

process should be performed.

UserState




Top

See Also

Reference



Settings Property Gets the UploadManagerSettingsPost that specifies how the upload process should be

performed.

Syntax


Public Shadows ReadOnly Property Settings As UploadManagerSettingsPost

C#

public new UploadManagerSettingsPost Settings {get;}

Requirements




See Also

Reference



Events %%scrap%%

" -->

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

71

Public Events

Name Description

MIMETypeRequested This event will be raised for each file, to customize the Content-

Type http header.





Top

See Also

Reference



MIMETypeRequested Event This event will be raised for each file, to customize the Content-Type http header.

Syntax


Public Event MIMETypeRequested As

C1UploaderPost.MIMETypeRequestedEventHandler

C#

public event C1UploaderPost.MIMETypeRequestedEventHandler MIMETypeRequested

Event Data

The event handler receives an argument of type MIMETypeRequestedEventArgs containing data

related to this event. The following MIMETypeRequestedEventArgs properties provide



FileExtension The extension requested, including the ".".

Requirements

72




See Also

Reference



C1UploaderWebService Represents a class that uploads files to the server using Web services.

Object Model

Syntax


Public Class C1UploaderWebService

Inherits C1Uploader

C#

public class C1UploaderWebService : C1Uploader


System.Object



Requirements




See Also

Reference

C1UploaderWebService Members


Overview Represents a class that uploads files to the server using Web services.

73

Object Model

Syntax


Public Class C1UploaderWebService

Inherits C1Uploader

C#

public class C1UploaderWebService : C1Uploader


System.Object



Requirements




See Also

Reference




The following tables list the members exposed by C1UploaderWebService.

Public Constructors

Name Description

C1UploaderWebService Constructor Overloaded.

Top

Public Properties

74

Name Description

Files Gets the collection of files that will be uploaded. (Inherited from




IsBusy Gets whether the component is currently uploading files. (Inherited





upload. (Inherited from C1.Silverlight.Uploader.C1Uploader)

Settings Gets the settings that will be used by the upload algorithm to do

the uploads.




Top

Public Methods

Name Description







BeginUploadFiles Begins uploading the files specified in the Files property. (Inherited


75

Cancel Cancels the current upload process. (Inherited from


Top

Public Events

Name Description





Top

See Also

Reference

C1UploaderWebService Class


C1UploaderWebService Constructor

Overload List


C1UploaderWebService Constructor(Uri) Initializes a new

instance of a

C1UploaderWebServ

ice.

C1UploaderWebService Constructor(FilesPerRequest) Initializes a new

instance of a

C1UploaderWebServ

ice.


Constructor(UploadManagerSettingsWebService)

Initializes a new

instance of a

C1UploaderWebServ

ice.

76


Constructor(UploadManagerSettingsWebService,FilePackager)

Initializes a new

instance of a

C1UploaderWebServ

ice.

Requirements




See Also

Reference



C1UploaderWebService Constructor(Uri) Address of the service that will receive the upload

Initializes a new instance of a C1UploaderWebService.

Syntax




)

C#

public C1UploaderWebService(

System.Uri address

)

Parameters

address

Address of the service that will receive the upload

Requirements




See Also

77

Reference



Overload List

C1UploaderWebService Constructor(FilesPerRequest) Splitter mode used to upload the files


Syntax



ByVal splitter As FilesPerRequest _

)

C#


FilesPerRequest splitter

)

Parameters

splitter

Splitter mode used to upload the files

Requirements




See Also

Reference



Overload List

C1UploaderWebService Constructor(UploadManagerSettingsWebService) Settings that will be used by the upload algorithm to do the uploads


Syntax

78



ByVal settings As UploadManagerSettingsWebService _

)

C#


UploadManagerSettingsWebService settings

)

Parameters

settings

Settings that will be used by the upload algorithm to do the uploads

Requirements




See Also

Reference



Overload List


Constructor(UploadManagerSettingsWebService,FilePackager) Settings that will be used by the upload algorithm to do the uploads


Syntax



ByVal settings As UploadManagerSettingsWebService, _

ByVal algorithm As FilePackager _

)

C#


79

UploadManagerSettingsWebService settings,

FilePackager algorithm

)

Parameters

settings

Settings that will be used by the upload algorithm to do the uploads

algorithm

Requirements




See Also

Reference



Overload List

Properties >

Name Description

Files

Gets the collection of files that will be uploaded. (Inherited from


Headers

Gets the headers that will be sent to the server with each upload.


IsBusy

Gets whether the component is currently uploading files. (Inherited


MaximumUploadSize

Gets or sets the maximum size in bytes allowed for each upload.


Parameters

Gets the parameters that will be sent to the server with each upload.


Settings

Gets the settings that will be used by the upload algorithm to do the

uploads.

UserState




80

Top

See Also

Reference



Settings Property Gets the settings that will be used by the upload algorithm to do the uploads.

Syntax


Public Shadows ReadOnly Property Settings As

UploadManagerSettingsWebService

C#

public new UploadManagerSettingsWebService Settings {get;}

Requirements




See Also

Reference



FilePackager Represents an object that maps files into server requests.

Object Model

Syntax


Public MustInherit Class FilePackager

C#

81

public abstract class FilePackager

Remarks

FilePackager is the abstract base class of FilePackagerSingleFile, which uploads one file per

request, FilePackagerMultiFile, which uploads multiple files per request, and

FilePackagerPartialFile, which uploads partial files in each request.


System.Object

C1.Silverlight.Uploader.FilePackager

C1.Silverlight.Uploader.FilePackagerMultiFile

C1.Silverlight.Uploader.FilePackagerPartialFile

C1.Silverlight.Uploader.FilePackagerSingleFile

Requirements




See Also

Reference

FilePackager Members


Overview Represents an object that maps files into server requests.

Object Model

Syntax


Public MustInherit Class FilePackager

C#

public abstract class FilePackager

Remarks

FilePackager is the abstract base class of FilePackagerSingleFile, which uploads one file per

request, FilePackagerMultiFile, which uploads multiple files per request, and

FilePackagerPartialFile, which uploads partial files in each request.

82


System.Object





Requirements




See Also

Reference



Members Properties Methods

The following tables list the members exposed by FilePackager.

Public Properties

Name Description

Files Gets or sets a list of files to be uploaded.

MaximumUploadSize Gets or sets the maximum size allowed per upload request.

Top

Public Methods

Name Description

GetMaxSizePerUpload Gets the maximum size needed to upload the files.

GetPackages Gets a set of packages that should be uploaded

GetTotalSize Gets the total size of all in the Files collection.

Top

See Also

83

Reference

FilePackager Class


Methods %%scrap%%

" -->

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

Public Methods

Name Description

GetMaxSizePerUpload Gets the maximum size needed to upload the files.

GetPackages Gets a set of packages that should be uploaded

GetTotalSize Gets the total size of all in the Files collection.

Top

See Also

Reference

FilePackager Class


GetMaxSizePerUpload Method Gets the maximum size needed to upload the files.

Syntax


Public MustOverride Function GetMaxSizePerUpload() As System.Long

C#

public abstract System.long GetMaxSizePerUpload()

Return Value

Maximum size needed to upload the files

Requirements

84




See Also

Reference

FilePackager Class


GetPackages Method Gets a set of packages that should be uploaded

Syntax


Public MustOverride Function GetPackages() As

System.Collections.Generic.IEnumerable(Of UploadFilePartPackage)

C#

public abstract

System.Collections.Generic.IEnumerable<UploadFilePartPackage> GetPackages()

Return Value

Set of packages that should be uploaded

Requirements




See Also

Reference

FilePackager Class


GetTotalSize Method Gets the total size of all in the Files collection.

Syntax


Public Function GetTotalSize() As System.Long

85

C#

public System.long GetTotalSize()

Return Value

Amount of size of all files

Requirements




See Also

Reference

FilePackager Class


Properties >

Name Description

Files Gets or sets a list of files to be uploaded.


Top

See Also

Reference

FilePackager Class


Files Property Gets or sets a list of files to be uploaded.

Syntax


Public Property Files As System.Collections.Generic.List(Of UploadFileInfo)

C#

public System.Collections.Generic.List<UploadFileInfo> Files {get; set;}

Requirements

86




See Also

Reference

FilePackager Class


MaximumUploadSize Property Gets or sets the maximum size allowed per upload request.

Syntax


Public Property MaximumUploadSize As System.Long

C#

public System.long MaximumUploadSize {get; set;}

Requirements




See Also

Reference

FilePackager Class


FilePackagerFactory Static class that creates FilePackager objects.

Object Model

Syntax


Public MustInherit NotInheritable Class FilePackagerFactory

87

C#

public static class FilePackagerFactory


System.Object

C1.Silverlight.Uploader.FilePackagerFactory

Requirements




See Also

Reference

FilePackagerFactory Members


Overview Static class that creates FilePackager objects.

Object Model

Syntax


Public MustInherit NotInheritable Class FilePackagerFactory

C#

public static class FilePackagerFactory


System.Object

C1.Silverlight.Uploader.FilePackagerFactory

Requirements




See Also

88

Reference



Members Methods

The following tables list the members exposed by FilePackagerFactory.

Public Methods

Name Description

Create Creates FilePackager objects.

Top

See Also

Reference

FilePackagerFactory Class


Methods %%scrap%%

" -->

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

Public Methods

Name Description

Create Creates FilePackager objects.

Top

See Also

Reference



Create Method FilesPerRequest value that specifies the type of FilePackager to create.

Creates FilePackager objects.

89

Syntax


Public Shared Function Create( _

ByVal mode As FilesPerRequest _

) As FilePackager

C#

public static FilePackager Create(

FilesPerRequest mode

)

Parameters

mode

FilesPerRequest value that specifies the type of FilePackager to create.

Return Value

A new FilePackager object.

Requirements




See Also

Reference



FilePackagerMultiFile FilePackager that packages multiple files per request.

Object Model

Syntax


Public Class FilePackagerMultiFile

Inherits FilePackager

90

C#

public class FilePackagerMultiFile : FilePackager


System.Object



Requirements




See Also

Reference

FilePackagerMultiFile Members


Overview FilePackager that packages multiple files per request.

Object Model

Syntax


Public Class FilePackagerMultiFile


C#

public class FilePackagerMultiFile : FilePackager


System.Object



Requirements

91




See Also

Reference




The following tables list the members exposed by FilePackagerMultiFile.

Public Constructors

Name Description

FilePackagerMultiFile Constructor Initializes a new instance of a FilePackagerMultiFile.

Top

Public Properties

Name Description

Files Gets or sets a list of files to be uploaded. (Inherited from

C1.Silverlight.Uploader.FilePackager)


(Inherited from C1.Silverlight.Uploader.FilePackager)

Top

Public Methods

Name Description

GetMaxSizePerUpload Overridden. Gets the maximum amount of size needed to upload

the files

GetPackages Overridden. Gets a set of packages that should be uploaded

92

GetTotalSize Gets the total size of all in the Files collection. (Inherited from


Top

See Also

Reference

FilePackagerMultiFile Class


FilePackagerMultiFile Constructor Initializes a new instance of a FilePackagerMultiFile.

Syntax


Public Function New()

C#

public FilePackagerMultiFile()

Requirements




See Also

Reference



Methods >

Name Description

GetMaxSizePerUpload

Overridden. Gets the maximum amount of size needed to upload

the files


GetTotalSize

Gets the total size of all in the Files collection. (Inherited from


93

Top

See Also

Reference



GetMaxSizePerUpload Method Gets the maximum amount of size needed to upload the files

Syntax


Public Overrides Function GetMaxSizePerUpload() As System.Long

C#

public override System.long GetMaxSizePerUpload()

Return Value

Maximum amount of size needed to upload the files

Requirements




See Also

Reference




Syntax


Public Overrides Function GetPackages() As


C#

94

public override


Return Value


Requirements




See Also

Reference



FilePackagerPartialFile FilePackager that breaks up files into multiple requests.

Object Model

Syntax


Public Class FilePackagerPartialFile


C#

public class FilePackagerPartialFile : FilePackager


System.Object



Requirements




See Also

95

Reference

FilePackagerPartialFile Members


Overview FilePackager that breaks up files into multiple requests.

Object Model

Syntax


Public Class FilePackagerPartialFile


C#

public class FilePackagerPartialFile : FilePackager


System.Object



Requirements




See Also

Reference




The following tables list the members exposed by FilePackagerPartialFile.

Public Constructors

Name Description

96

FilePackagerPartialFile Constructor Initializes a new instance of a FilePackagerPartialFile.

Top

Public Properties

Name Description





Top

Public Methods

Name Description

GetMaxSizePerUpload Overridden. Gets the size needed to upload the files.

GetPackages Overridden. Gets a set of packages that should be uploaded.



Top

See Also

Reference

FilePackagerPartialFile Class


FilePackagerPartialFile Constructor Initializes a new instance of a FilePackagerPartialFile.

Syntax



C#

97

public FilePackagerPartialFile()

Requirements




See Also

Reference



Methods %%scrap%%

" -->

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

Public Methods

Name Description

GetMaxSizePerUpload Overridden. Gets the size needed to upload the files.

GetPackages Overridden. Gets a set of packages that should be uploaded.



Top

See Also

Reference



GetMaxSizePerUpload Method Gets the size needed to upload the files.

Syntax



98

C#


Return Value


Requirements




See Also

Reference



GetPackages Method Gets a set of packages that should be uploaded.

Syntax




C#

public override


Return Value

Set of packages that should be uploaded.

Requirements




See Also

Reference



99

FilePackagerSingleFile FilePackager that packages one file per request.

Object Model

Syntax


Public Class FilePackagerSingleFile


C#

public class FilePackagerSingleFile : FilePackager


System.Object



Requirements




See Also

Reference

FilePackagerSingleFile Members


Overview FilePackager that packages one file per request.

Object Model

Syntax


Public Class FilePackagerSingleFile

100


C#

public class FilePackagerSingleFile : FilePackager


System.Object



Requirements




See Also

Reference




The following tables list the members exposed by FilePackagerSingleFile.

Public Constructors

Name Description

FilePackagerSingleFile Constructor Initializes a new instance of a FilePackagerSingleFile.

Top

Public Properties

Name Description





Top

101

Public Methods

Name Description

GetMaxSizePerUpload Overridden. Gets the maximum upload size needed to upload the

files.




Top

See Also

Reference

FilePackagerSingleFile Class


FilePackagerSingleFile Constructor Initializes a new instance of a FilePackagerSingleFile.

Syntax



C#

public FilePackagerSingleFile()

Requirements




See Also

Reference



Methods %%scrap%%

102

" -->

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

Public Methods

Name Description

GetMaxSizePerUpload Overridden. Gets the maximum upload size needed to upload the

files.




Top

See Also

Reference



GetMaxSizePerUpload Method Gets the maximum upload size needed to upload the files.

Syntax



C#


Return Value


Requirements




See Also

103

Reference




Syntax




C#

public override


Return Value


Requirements




See Also

Reference



InvalidAddressException This exception is raised if the address of the service to be called is not correct.

Object Model

Syntax


Public Class InvalidAddressException

Inherits System.Exception

104

C#

public class InvalidAddressException : System.Exception


System.Object

System.Exception

C1.Silverlight.Uploader.InvalidAddressException

Requirements




See Also

Reference

InvalidAddressException Members


Overview This exception is raised if the address of the service to be called is not correct.

Object Model

Syntax


Public Class InvalidAddressException


C#

public class InvalidAddressException : System.Exception


System.Object

System.Exception

C1.Silverlight.Uploader.InvalidAddressException

Requirements

105




See Also

Reference




The following tables list the members exposed by InvalidAddressException.

Public Constructors

Name Description

InvalidAddressException Constructor Overloaded.

Top

Public Properties

Name Description

Data (Inherited from System.Exception)

HelpLink (Inherited from System.Exception)

HResult (Inherited from System.Exception)

InnerException (Inherited from System.Exception)

Message (Inherited from System.Exception)

Source (Inherited from System.Exception)

StackTrace (Inherited from System.Exception)

TargetSite (Inherited from System.Exception)

Top

Public Methods

106

Name Description

GetBaseException (Inherited from System.Exception)

GetObjectData (Inherited from System.Exception)

GetType (Inherited from System.Exception)

ToString (Inherited from System.Exception)

Top

See Also

Reference

InvalidAddressException Class


InvalidAddressException Constructor

Overload List


InvalidAddressException Constructor() Initializes a new instance of a

InvalidAddressException.

InvalidAddressException Constructor(Exception) Initializes a new instance of a

InvalidAddressException.

Requirements




See Also

Reference



InvalidAddressException Constructor() Initializes a new instance of a InvalidAddressException.

Syntax

107



C#

public InvalidAddressException()

Requirements




See Also

Reference



Overload List

InvalidAddressException Constructor(Exception) the exception that is the cause of the current exception

Initializes a new instance of a InvalidAddressException.

Syntax



ByVal innerException As System.Exception _

)

C#

public InvalidAddressException(

System.Exception innerException

)

Parameters

innerException

the exception that is the cause of the current exception

Requirements




108

See Also

Reference



Overload List

MaximumUploadSizeExceededException This exception is raised when the size needed to do the upload is greater than the size specified

by the user.

Object Model

Syntax


Public Class MaximumUploadSizeExceededException


C#

public class MaximumUploadSizeExceededException : System.Exception


System.Object

System.Exception

C1.Silverlight.Uploader.MaximumUploadSizeExceededException

Requirements




See Also

Reference

MaximumUploadSizeExceededException Members


Overview This exception is raised when the size needed to do the upload is greater than the size specified

by the user.

109

Object Model

Syntax


Public Class MaximumUploadSizeExceededException


C#

public class MaximumUploadSizeExceededException : System.Exception


System.Object

System.Exception

C1.Silverlight.Uploader.MaximumUploadSizeExceededException

Requirements




See Also

Reference




The following tables list the members exposed by MaximumUploadSizeExceededException.

Public Constructors

Name Description

MaximumUploadSizeExceededException

Constructor

Initializes a new instance of a

MaximumUploadSizeExceededExceptio

n.

Top

110

Public Properties

Name Description

Data (Inherited from System.Exception)

HelpLink (Inherited from System.Exception)

HResult (Inherited from System.Exception)

InnerException (Inherited from System.Exception)

Message (Inherited from System.Exception)

Source (Inherited from System.Exception)

StackTrace (Inherited from System.Exception)

TargetSite (Inherited from System.Exception)

Top

Public Methods

Name Description

GetBaseException (Inherited from System.Exception)

GetObjectData (Inherited from System.Exception)

GetType (Inherited from System.Exception)

ToString (Inherited from System.Exception)

Top

See Also

Reference

MaximumUploadSizeExceededException Class


MaximumUploadSizeExceededException Constructor Initializes a new instance of a MaximumUploadSizeExceededException.

111

Syntax



C#

public MaximumUploadSizeExceededException()

Requirements




See Also

Reference

MaximumUploadSizeExceededException Class


MIMETypeRequestedEventArgs Provides data for the C1UploaderPost.MIMETypeRequested event.

Object Model

Syntax


Public Class MIMETypeRequestedEventArgs

Inherits System.EventArgs

C#

public class MIMETypeRequestedEventArgs : System.EventArgs


System.Object

System.EventArgs

C1.Silverlight.Uploader.MIMETypeRequestedEventArgs

Requirements

112




See Also

Reference

MIMETypeRequestedEventArgs Members


Overview Provides data for the C1UploaderPost.MIMETypeRequested event.

Object Model

Syntax


Public Class MIMETypeRequestedEventArgs


C#

public class MIMETypeRequestedEventArgs : System.EventArgs


System.Object

System.EventArgs

C1.Silverlight.Uploader.MIMETypeRequestedEventArgs

Requirements




See Also

Reference



Members Properties

113

The following tables list the members exposed by MIMETypeRequestedEventArgs.

Public Properties

Name Description


Top

See Also

Reference

MIMETypeRequestedEventArgs Class


Properties >

Name Description


Top

See Also

Reference



FileExtension Property The extension requested, including the ".".

Syntax


Public ReadOnly Property FileExtension As System.String

C#

public System.string FileExtension {get;}

Requirements




114

See Also

Reference



UploadCompletedEventArgs Contains data about upload completed event of the upload file

Object Model

Syntax


Public Class UploadCompletedEventArgs

Inherits System.ComponentModel.AsyncCompletedEventArgs

C#

public class UploadCompletedEventArgs :

System.ComponentModel.AsyncCompletedEventArgs


System.Object

System.EventArgs


C1.Silverlight.Uploader.UploadCompletedEventArgs

Requirements




See Also

Reference

UploadCompletedEventArgs Members


Overview Contains data about upload completed event of the upload file

Object Model

115

Syntax


Public Class UploadCompletedEventArgs

Inherits System.ComponentModel.AsyncCompletedEventArgs

C#

public class UploadCompletedEventArgs :



System.Object

System.EventArgs


C1.Silverlight.Uploader.UploadCompletedEventArgs

Requirements




See Also

Reference



Members Properties

The following tables list the members exposed by UploadCompletedEventArgs.

Public Constructors

Name Description

UploadCompletedEventArgs Constructor Initializes a new instance of a

UploadCompletedEventArgs.

Top

Public Properties

116

Name Description







Top

See Also

Reference

UploadCompletedEventArgs Class


UploadCompletedEventArgs Constructor True if all the files were uploaded successfully

True if the user cancelled the request

Exception returned if something was wrong

Array of names of the files uploaded

Response returned by the server in the message body

Additional information attached by the user

Initializes a new instance of a UploadCompletedEventArgs.

Syntax



ByVal success As System.Boolean, _

ByVal cancelled As System.Boolean, _

ByVal error As System.Exception, _

ByVal files() As System.String, _

ByVal response As System.Object, _

117

ByVal userState As System.Object _

)

C#

public UploadCompletedEventArgs(

System.bool success,

System.bool cancelled,

System.Exception error,

System.string[] files,

System.object response,

System.object userState

)

Parameters

success

True if all the files were uploaded successfully

cancelled

True if the user cancelled the request

error

Exception returned if something was wrong

files

Array of names of the files uploaded

response

Response returned by the server in the message body

userState


Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later,

Windows XP SP3, Windows Server 2008 (Server Core not

supported), Windows Server 2008 R2 (Server Core supported


See Also

Reference



118

Properties >

Name Description







Top

See Also

Reference



Files Property Array of names of the files uploaded

Syntax


Public ReadOnly Property Files As System.String()

C#

public System.string[] Files {get;}

Requirements




See Also

Reference






119

Response Property Response returned by the server in the message body.

Syntax


Public ReadOnly Property Response As System.Object

C#

public System.object Response {get;}

Requirements




See Also

Reference



Success Property True if all the files were uploaded successfully.

Syntax


Public ReadOnly Property Success As System.Boolean

C#

public System.bool Success {get;}

Requirements




See Also

Reference



120

UploadFileInfo Wraps the information of files that comes from different sources.

Object Model

Syntax


Public Class UploadFileInfo

C#

public class UploadFileInfo


System.Object

C1.Silverlight.Uploader.UploadFileInfo

Requirements




See Also

Reference

UploadFileInfo Members


Overview Wraps the information of files that comes from different sources.

Object Model

Syntax


Public Class UploadFileInfo

C#

121

public class UploadFileInfo


System.Object

C1.Silverlight.Uploader.UploadFileInfo

Requirements




See Also

Reference




The following tables list the members exposed by UploadFileInfo.

Public Constructors

Name Description

UploadFileInfo Constructor Overloaded.

Top

Public Properties

Name Description

File Data of the file.

Name Name of the file.

Top

Public Methods

Name Description

Close Closes the file if it is opened.

122

GetSize Gets the size in bytes of a file.

Prepare Opens the file if it is not opened.

Top

See Also

Reference

UploadFileInfo Class


UploadFileInfo Constructor

Overload List


UploadFileInfo Constructor(FileInfo) Initializes a new instance of a UploadFileInfo.

UploadFileInfo Constructor(String) Initializes a new instance of a UploadFileInfo.

UploadFileInfo Constructor(String,Stream) Initializes a new instance of a UploadFileInfo.

Requirements




See Also

Reference



UploadFileInfo Constructor(FileInfo) File that comes from System.Windows.Controls.OpenFileDialog

Initializes a new instance of a UploadFileInfo.

Syntax



ByVal file As System.IO.FileInfo _

123

)

C#

public UploadFileInfo(

System.IO.FileInfo file

)

Parameters

file

File that comes from System.Windows.Controls.OpenFileDialog

Requirements




See Also

Reference



Overload List

UploadFileInfo Constructor(String) Name of the file in the Isolated Storage


Syntax



ByVal fileName As System.String _

)

C#


System.string fileName

)

Parameters

fileName

Name of the file in the Isolated Storage

124

Requirements




See Also

Reference



Overload List

UploadFileInfo Constructor(String,Stream) Name of the file

Stream that contains the data of the file


Syntax



ByVal name As System.String, _

ByVal file As System.IO.Stream _

)

C#


System.string name,

System.IO.Stream file

)

Parameters

name

Name of the file

file

Stream that contains the data of the file

Requirements




125

See Also

Reference



Overload List

Methods %%scrap%%

" -->

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

Public Methods

Name Description

Close Closes the file if it is opened.

GetSize Gets the size in bytes of a file.

Prepare Opens the file if it is not opened.

Top

See Also

Reference



Close Method Closes the file if it is opened.

Syntax


Public Sub Close()

C#

public void Close()

Requirements

126




See Also

Reference



GetSize Method Gets the size in bytes of a file.

Syntax


Public Function GetSize() As System.Long

C#

public System.long GetSize()

Return Value

Return the size in bytes of a file.

Remarks

If the Prepare method has not been called the size will be 0.

Requirements




See Also

Reference



Prepare Method Opens the file if it is not opened.

Syntax


127

Public Sub Prepare()

C#

public void Prepare()

Requirements




See Also

Reference



Properties %%scrap%%

" -->

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

Public Properties

Name Description

File Data of the file.

Name Name of the file.

Top

See Also

Reference



File Property Data of the file.

Syntax


Public ReadOnly Property File As System.IO.Stream

128

C#

public System.IO.Stream File {get;}

Requirements




See Also

Reference



Name Property Name of the file.

Syntax


Public ReadOnly Property Name As System.String

C#

public System.string Name {get;}

Requirements




See Also

Reference



UploadFilePartInfo Represents a file part. It can be a file or a file segment.

Object Model

Syntax

129


Public Class UploadFilePartInfo

C#

public class UploadFilePartInfo


System.Object

C1.Silverlight.Uploader.UploadFilePartInfo

Requirements




See Also

Reference

UploadFilePartInfo Members


Overview Represents a file part. It can be a file or a file segment.

Object Model

Syntax


Public Class UploadFilePartInfo

C#

public class UploadFilePartInfo


System.Object

C1.Silverlight.Uploader.UploadFilePartInfo

Requirements

130




See Also

Reference




The following tables list the members exposed by UploadFilePartInfo.

Public Constructors

Name Description

UploadFilePartInfo Constructor Overloaded.

Top

Public Properties

Name Description

Data Gets the data of the file part

Name Gets the name of the file part.

PartCount Gets the total number of parts associated with the owner file.

PartNumber Gets the index of a part within the owner file.

Top

Public Methods

Name Description

GetSize Gets the size of a file part.

Top

See Also

Reference

131

UploadFilePartInfo Class


UploadFilePartInfo Constructor

Overload List


UploadFilePartInfo Constructor(String,Byte[],Int32,Int32) Initializes a new instance of a

UploadFilePartInfo.

UploadFilePartInfo Constructor(UploadFileInfo) Initializes a new instance of a

UploadFilePartInfo.

Requirements




See Also

Reference



UploadFilePartInfo Constructor(String,Byte[],Int32,Int32) Name of the file part

Data of the file part

Index of the file part in the file

Total number of parts for the file

Initializes a new instance of a UploadFilePartInfo.

Syntax



ByVal filePartName As System.String, _

ByVal filePartData() As System.Byte, _

ByVal partNumber As System.Integer, _

ByVal partCount As System.Integer _

)

132

C#

public UploadFilePartInfo(

System.string filePartName,

System.byte[] filePartData,

System.int partNumber,

System.int partCount

)

Parameters

filePartName

Name of the file part

filePartData

Data of the file part

partNumber

Index of the file part in the file

partCount

Total number of parts for the file

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP

SP3, Windows Server 2008 (Server Core not supported), Windows Server

2008 R2 (Server Core supported with SP1 or later), Windows Server 2003

SP2

See Also

Reference



Overload List

UploadFilePartInfo Constructor(UploadFileInfo) File that will be wrapped in a UploadFilePartInfo

Initializes a new instance of a UploadFilePartInfo.

Syntax



ByVal file As UploadFileInfo _

133

)

C#

public UploadFilePartInfo(

UploadFileInfo file

)

Parameters

file

File that will be wrapped in a UploadFilePartInfo

Requirements




See Also

Reference



Overload List

Methods %%scrap%%

" -->

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

Public Methods

Name Description

GetSize Gets the size of a file part.

Top

See Also

Reference



GetSize Method Gets the size of a file part.

134

Syntax



C#


Return Value

Size of the file part.

Requirements




See Also

Reference



Properties >

Name Description

Data Gets the data of the file part

Name Gets the name of the file part.

PartCount Gets the total number of parts associated with the owner file.

PartNumber Gets the index of a part within the owner file.

Top

See Also

Reference



Data Property Gets the data of the file part

Syntax

135


Public ReadOnly Property Data As System.Byte()

C#

public System.byte[] Data {get;}

Requirements




See Also

Reference



Name Property Gets the name of the file part.

Syntax


Public ReadOnly Property Name As System.String

C#

public System.string Name {get;}

Requirements




See Also

Reference



PartCount Property Gets the total number of parts associated with the owner file.

Syntax

136


Public ReadOnly Property PartCount As System.Integer

C#

public System.int PartCount {get;}

Requirements




See Also

Reference



PartNumber Property Gets the index of a part within the owner file.

Syntax


Public ReadOnly Property PartNumber As System.Integer

C#

public System.int PartNumber {get;}

Requirements




See Also

Reference



UploadFilePartPackage Contains a sets of UploadFilePartInfo.

Object Model

137

Syntax


Public Class UploadFilePartPackage

Inherits System.Collections.Generic.List(Of UploadFilePartInfo)

C#

public class UploadFilePartPackage :

System.Collections.Generic.List<UploadFilePartInfo>


System.Object

System.Collections.Generic.List<T>

C1.Silverlight.Uploader.UploadFilePartPackage

Requirements




See Also

Reference

UploadFilePartPackage Members


Overview Contains a sets of UploadFilePartInfo.

Object Model

Syntax


Public Class UploadFilePartPackage

Inherits System.Collections.Generic.List(Of UploadFilePartInfo)

C#

138

public class UploadFilePartPackage :

System.Collections.Generic.List<UploadFilePartInfo>


System.Object

System.Collections.Generic.List<T>

C1.Silverlight.Uploader.UploadFilePartPackage

Requirements




See Also

Reference




The following tables list the members exposed by UploadFilePartPackage.

Public Constructors

Name Description

UploadFilePartPackage Constructor

Top

Public Properties

Name Description

Capacity (Inherited from

System.Collections.Generic.List<UploadFilePartInfo>)

Count (Inherited from


Item (Inherited from


139

ServerWaitForOneFile Gets or sets whether the package should be uploaded as a one

only file package.

Top

Public Methods

Name Description

Add (Inherited from


AddRange (Inherited from


AsReadOnly (Inherited from


BinarySearch Overloaded. (Inherited from


Clear (Inherited from


Contains (Inherited from


ConvertAll<TOutput> (Inherited from


CopyTo Overloaded. (Inherited from


Exists (Inherited from


Find (Inherited from


140

FindAll (Inherited from


FindIndex Overloaded. (Inherited from


FindLast (Inherited from


FindLastIndex Overloaded. (Inherited from


ForEach (Inherited from


GetEnumerator (Inherited from


GetRange (Inherited from


GetSize Gets the size of the package.

IndexOf Overloaded. (Inherited from


Insert (Inherited from


InsertRange (Inherited from


LastIndexOf Overloaded. (Inherited from


Remove (Inherited from


141

RemoveAll (Inherited from


RemoveAt (Inherited from


RemoveRange (Inherited from


Reverse Overloaded. (Inherited from


Sort Overloaded. (Inherited from


ToArray (Inherited from


TrimExcess (Inherited from


TrueForAll (Inherited from


Top

See Also

Reference

UploadFilePartPackage Class


UploadFilePartPackage Constructor

Syntax



C#

public UploadFilePartPackage()

142

Requirements




See Also

Reference



Methods %%scrap%%

" -->

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

Public Methods

Name Description

Add (Inherited from


AddRange (Inherited from


AsReadOnly (Inherited from


BinarySearch Overloaded. (Inherited from


Clear (Inherited from


Contains (Inherited from


ConvertAll<TOutput> (Inherited from


C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~Add.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~AddRange.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~AsReadOnly.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~BinarySearch.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~Clear.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~Contains.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~ConvertAll.html

143

CopyTo Overloaded. (Inherited from


Exists (Inherited from


Find (Inherited from


FindAll (Inherited from


FindIndex Overloaded. (Inherited from


FindLast (Inherited from


FindLastIndex Overloaded. (Inherited from


ForEach (Inherited from


GetEnumerator (Inherited from


GetRange (Inherited from


GetSize Gets the size of the package.

IndexOf Overloaded. (Inherited from


Insert (Inherited from


C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~CopyTo.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~Exists.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~Find.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~FindAll.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~FindIndex.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~FindLast.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~FindLastIndex.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~ForEach.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~GetEnumerator.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~GetRange.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~IndexOf.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~Insert.html

144

InsertRange (Inherited from


LastIndexOf Overloaded. (Inherited from


Remove (Inherited from


RemoveAll (Inherited from


RemoveAt (Inherited from


RemoveRange (Inherited from


Reverse Overloaded. (Inherited from


Sort Overloaded. (Inherited from


ToArray (Inherited from


TrimExcess (Inherited from


TrueForAll (Inherited from


Top

See Also

Reference



C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~InsertRange.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~LastIndexOf.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~Remove.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~RemoveAll.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~RemoveAt.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~RemoveRange.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~Reverse.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~Sort.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~ToArray.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~TrimExcess.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~TrueForAll.html

145

GetSize Method Gets the size of the package.

Syntax



C#


Return Value

Size of the package.

Requirements




See Also

Reference



Properties >

Name Description

Capacity (Inherited from System.Collections.Generic.List<UploadFilePartInfo>)

Count (Inherited from System.Collections.Generic.List<UploadFilePartInfo>)

Item (Inherited from System.Collections.Generic.List<UploadFilePartInfo>)

ServerWaitForOneFile

Gets or sets whether the package should be uploaded as a one only

file package.

Top

See Also

Reference



C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~Capacity.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~Count.html

C1.Silverlight.Uploader.5~C1.Silverlight.Uploader.UploadFilePartPackage~Item.html

146

ServerWaitForOneFile Property Gets or sets whether the package should be uploaded as a one only file package.

Syntax


Public Property ServerWaitForOneFile As System.Boolean

C#

public System.bool ServerWaitForOneFile {get; set;}

Requirements




See Also

Reference



UploadManagerPost Class that packages files into multipart POST requests.

Object Model

Syntax


Public Class UploadManagerPost

Implements IUploadManager

C#

public class UploadManagerPost : IUploadManager


System.Object

C1.Silverlight.Uploader.UploadManagerPost

Requirements

147




See Also

Reference

UploadManagerPost Members


Overview Class that packages files into multipart POST requests.

Object Model

Syntax


Public Class UploadManagerPost


C#

public class UploadManagerPost : IUploadManager


System.Object

C1.Silverlight.Uploader.UploadManagerPost

Requirements




See Also

Reference



Members Methods Events

The following tables list the members exposed by UploadManagerPost.

148

Public Constructors

Name Description

UploadManagerPost Constructor

Top

Public Methods

Name Description

BeginUpload Begins the upload of a set of parts.

Cancel Aborts the execution of the upload.

Top

Public Events

Name Description

UploadCompleted It is raised when the upload has been completed.


Top

See Also

Reference

UploadManagerPost Class


UploadManagerPost Constructor

Syntax



C#

public UploadManagerPost()

Requirements

149




See Also

Reference



Methods >

Name Description

BeginUpload Begins the upload of a set of parts.


Top

See Also

Reference



BeginUpload Method Settings used to upload the part.

Package of file parts to be uploaded.

Headers that will be sent within the upload.

Parameter that will be sent to the server together with the part.

Begins the upload of a set of parts.

Syntax


Public Function BeginUpload( _

ByVal settings As UploadManagerSettings, _

ByVal package As UploadFilePartPackage, _

ByVal headers As System.Collections.Generic.Dictionary(Of

HttpRequestHeader,String), _

ByVal parameters As System.Collections.Generic.Dictionary(Of

String,String) _

150

) As System.Boolean

C#

public System.bool BeginUpload(

UploadManagerSettings settings,

UploadFilePartPackage package,

System.Collections.Generic.Dictionary<HttpRequestHeader,string> headers,

System.Collections.Generic.Dictionary<string,string> parameters

)

Parameters

settings

Settings used to upload the part.

package


headers


parameters


Return Value

Returns True if the upload has been started correctly.

Requirements




SP2

See Also

Reference



Cancel Method Aborts the execution of the upload.

Syntax


151

Public Sub Cancel()

C#

public void Cancel()

Requirements




See Also

Reference



Events %%scrap%%

" -->

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

Public Events

Name Description



Top

See Also

Reference



UploadCompleted Event It is raised when the upload has been completed.

Syntax


152



C#


Event Data











Requirements




See Also

Reference




Syntax





153



C#



Event Data









Requirements




See Also

Reference



UploadManagerSettings Contains parameters that specify the behavior of IUploadManager objects.

Object Model

Syntax


154

Public MustInherit Class UploadManagerSettings

C#

public abstract class UploadManagerSettings


System.Object

C1.Silverlight.Uploader.UploadManagerSettings

C1.Silverlight.Uploader.UploadManagerSettingsPost

C1.Silverlight.Uploader.UploadManagerSettingsWebService

Requirements




See Also

Reference

UploadManagerSettings Members


Overview Contains parameters that specify the behavior of IUploadManager objects.

Object Model

Syntax


Public MustInherit Class UploadManagerSettings

C#

public abstract class UploadManagerSettings


System.Object




Requirements

155




See Also

Reference



Members Properties

The following tables list the members exposed by UploadManagerSettings.

Public Properties

Name Description

Address Gets or sets the address of the service that will receive the upload

Top

See Also

Reference

UploadManagerSettings Class


Properties >

Name Description


Top

See Also

Reference



Address Property Gets or sets the address of the service that will receive the upload

Syntax

156


Public Property Address As System.Uri

C#

public System.Uri Address {get; set;}

Requirements




See Also

Reference



UploadManagerSettingsPost Contains parameters that specify the behavior of UploadManagerPost objects.

Object Model

Syntax


Public Class UploadManagerSettingsPost

Inherits UploadManagerSettings

C#

public class UploadManagerSettingsPost : UploadManagerSettings


System.Object



Requirements




157

See Also

Reference

UploadManagerSettingsPost Members


Overview Contains parameters that specify the behavior of UploadManagerPost objects.

Object Model

Syntax


Public Class UploadManagerSettingsPost


C#

public class UploadManagerSettingsPost : UploadManagerSettings


System.Object



Requirements




See Also

Reference



Members Properties

The following tables list the members exposed by UploadManagerSettingsPost.

Public Constructors

158

Name Description

UploadManagerSettingsPost Constructor Overloaded.

Top

Public Properties

Name Description


(Inherited from C1.Silverlight.Uploader.UploadManagerSettings)

Boundary Gets or sets the boundary used to create the multipart post.

TransferEncoding Gets or sets the encoding used to transfer the parts to the server.

Top

See Also

Reference

UploadManagerSettingsPost Class


UploadManagerSettingsPost Constructor

Overload List


UploadManagerSettingsPost Constructor(Uri) Initializes a new instance of a

UploadManagerSettingsPost.

UploadManagerSettingsPost Constructor() Initializes a new instance of a

UploadManagerSettingsPost.

Requirements




See Also

Reference

159



UploadManagerSettingsPost Constructor(Uri) Address of the service that will receive the upload

Initializes a new instance of a UploadManagerSettingsPost.

Syntax




)

C#

public UploadManagerSettingsPost(

System.Uri address

)

Parameters

address

Address of the service that will receive the upload

Requirements




See Also

Reference



Overload List

UploadManagerSettingsPost Constructor() Initializes a new instance of a UploadManagerSettingsPost.

Syntax



160

C#

public UploadManagerSettingsPost()

Requirements




See Also

Reference



Overload List

Properties >

Name Description

Address

Gets or sets the address of the service that will receive the upload


Boundary Gets or sets the boundary used to create the multipart post.

TransferEncoding Gets or sets the encoding used to transfer the parts to the server.

Top

See Also

Reference



Boundary Property Gets or sets the boundary used to create the multipart post.

Syntax


Public Property Boundary As System.String

C#

public System.string Boundary {get; set;}

161

Remarks

If no boundary is specified the system will generate one randomly (Recommended).

Requirements




See Also

Reference



TransferEncoding Property Gets or sets the encoding used to transfer the parts to the server.

Syntax


Public Property TransferEncoding As MultipartPostEncoding

C#

public MultipartPostEncoding TransferEncoding {get; set;}

Requirements




See Also

Reference



UploadManagerSettingsWebService Contains parameters that specify the behavior of UploadManagerWebService objects.

Object Model

Syntax

162


Public Class UploadManagerSettingsWebService


C#

public class UploadManagerSettingsWebService : UploadManagerSettings


System.Object



Requirements




See Also

Reference

UploadManagerSettingsWebService Members


Overview Contains parameters that specify the behavior of UploadManagerWebService objects.

Object Model

Syntax


Public Class UploadManagerSettingsWebService


C#

public class UploadManagerSettingsWebService : UploadManagerSettings


163

System.Object



Requirements




See Also

Reference



Members Properties

The following tables list the members exposed by UploadManagerSettingsWebService.

Public Constructors

Name Description

UploadManagerSettingsWebService Constructor Overloaded.

Top

Public Properties

Name Description



MethodManyFiles Gets or sets the name of the WebMethod which receives the upload.

MethodOneFile Gets or sets the name of the WebMethod which receives the upload.

Namespace Gets or sets the namespace of the WebService which receive the

upload.

ParamFileData Gets or sets the name of the parameter that receives the data of the

part.

164

ParamFileName Gets or sets the name of the parameter that receives the name of the

part.

ParamFiles Gets or sets the name of the parameter that receives the list of files.

ParamParameters Gets or sets the name of the parameter that receives optional

parameters specified in the Uploader component.

ParamPartCount Gets or sets the name of the parameter that receives the number of

parts.

ParamPartNumber Gets or sets the name of the parameter that receives the index of the

part.

Top

See Also

Reference

UploadManagerSettingsWebService Class


UploadManagerSettingsWebService Constructor

Overload List


UploadManagerSettingsWebService Constructor(Uri) Initializes a new instance of a

UploadManagerSettingsWebService.

UploadManagerSettingsWebService Constructor() Initializes a new instance of a

UploadManagerSettingsWebService.

Requirements




See Also

Reference



165

UploadManagerSettingsWebService Constructor(Uri) System.Uri of the service that will receive the upload requests.

Initializes a new instance of a UploadManagerSettingsWebService.

Syntax




)

C#

public UploadManagerSettingsWebService(

System.Uri address

)

Parameters

address

System.Uri of the service that will receive the upload requests.

Requirements




See Also

Reference



Overload List

UploadManagerSettingsWebService Constructor() Initializes a new instance of a UploadManagerSettingsWebService.

Syntax



C#

public UploadManagerSettingsWebService()

166

Requirements




See Also

Reference



Overload List

Properties >

Name Description

Address

Gets or sets the address of the service that will receive the upload


MethodManyFiles Gets or sets the name of the WebMethod which receives the upload.

MethodOneFile Gets or sets the name of the WebMethod which receives the upload.

Namespace

Gets or sets the namespace of the WebService which receive the

upload.

ParamFileData

Gets or sets the name of the parameter that receives the data of the

part.

ParamFileName

Gets or sets the name of the parameter that receives the name of the

part.

ParamFiles Gets or sets the name of the parameter that receives the list of files.

ParamParameters

Gets or sets the name of the parameter that receives optional

parameters specified in the Uploader component.

ParamPartCount

Gets or sets the name of the parameter that receives the number of

parts.

ParamPartNumber

Gets or sets the name of the parameter that receives the index of the

part.

Top

See Also

Reference

167



MethodManyFiles Property Gets or sets the name of the WebMethod which receives the upload.

Syntax


Public Property MethodManyFiles As System.String

C#

public System.string MethodManyFiles {get; set;}

Remarks

Default value is UploadFiles.

Requirements




See Also

Reference



MethodOneFile Property Gets or sets the name of the WebMethod which receives the upload.

Syntax


Public Property MethodOneFile As System.String

C#

public System.string MethodOneFile {get; set;}

Remarks

Default value is UploadFile.

Requirements

168




See Also

Reference



Namespace Property Gets or sets the namespace of the WebService which receive the upload.

Syntax


Public Property Namespace As System.String

C#

public System.string Namespace {get; set;}

Remarks

Default value is http://tempuri.org/.

Requirements




See Also

Reference



ParamFileData Property Gets or sets the name of the parameter that receives the data of the part.

Syntax


Public Property ParamFileData As System.String

C#

169

public System.string ParamFileData {get; set;}

Remarks

The data is received as a string formatted in base64.Default value is fileData.

Requirements




See Also

Reference



ParamFileName Property Gets or sets the name of the parameter that receives the name of the part.

Syntax


Public Property ParamFileName As System.String

C#

public System.string ParamFileName {get; set;}

Remarks

Default value is filename.

Requirements




See Also

Reference



ParamFiles Property Gets or sets the name of the parameter that receives the list of files.

170

Syntax


Public Property ParamFiles As System.String

C#

public System.string ParamFiles {get; set;}

Remarks

Default value is files.

Requirements




See Also

Reference



ParamParameters Property Gets or sets the name of the parameter that receives optional parameters specified in the

Uploader component.

Syntax


Public Property ParamParameters As System.String

C#

public System.string ParamParameters {get; set;}

Remarks

Default value is parameters.

Requirements




171

See Also

Reference



ParamPartCount Property Gets or sets the name of the parameter that receives the number of parts.

Syntax


Public Property ParamPartCount As System.String

C#

public System.string ParamPartCount {get; set;}

Remarks

Default value is partCount.

Requirements




See Also

Reference



ParamPartNumber Property Gets or sets the name of the parameter that receives the index of the part.

Syntax


Public Property ParamPartNumber As System.String

C#

public System.string ParamPartNumber {get; set;}

Remarks

172

Default value is partNumber.

Requirements




See Also

Reference



UploadManagerWebService Class that packages files into Web Service requests.

Object Model

Syntax


Public Class UploadManagerWebService


C#

public class UploadManagerWebService : IUploadManager


System.Object

C1.Silverlight.Uploader.UploadManagerWebService

Requirements




See Also

Reference

UploadManagerWebService Members


173

Overview Class that packages files into Web Service requests.

Object Model

Syntax


Public Class UploadManagerWebService


C#

public class UploadManagerWebService : IUploadManager


System.Object

C1.Silverlight.Uploader.UploadManagerWebService

Requirements




See Also

Reference




The following tables list the members exposed by UploadManagerWebService.

Public Constructors

Name Description

UploadManagerWebService Constructor

Top

Public Methods

174

Name Description

BeginUpload Begins the upload of one part.


Top

Public Events

Name Description


UploadProgressChanged It is raised when the progress of the upload has changed.

Top

See Also

Reference

UploadManagerWebService Class


UploadManagerWebService Constructor

Syntax



C#

public UploadManagerWebService()

Requirements




See Also

Reference



175

Methods >

Name Description

BeginUpload Begins the upload of one part.


Top

See Also

Reference



BeginUpload Method Settings used to upload the part.




Begins the upload of one part.

Syntax


Public Function BeginUpload( _






String,String) _

) As System.Boolean

C#

public System.bool BeginUpload(





)

176

Parameters

settings

Settings used to upload the part.

package


headers


parameters


Return Value

Returns True, if the upload has been started correctly.

Requirements




SP2

See Also

Reference



Cancel Method Aborts the execution of the upload.

Syntax


Public Sub Cancel()

C#

public void Cancel()

Requirements




177

See Also

Reference



Events >

Name Description


UploadProgressChanged It is raised when the progress of the upload has changed.

Top

See Also

Reference



UploadCompleted Event It is raised when the upload has been completed.

Syntax




C#


Event Data









178





Requirements




See Also

Reference



UploadProgressChanged Event It is raised when the progress of the upload has changed.

Syntax




C#



Event Data








179



Requirements




See Also

Reference



UploadProgressChangedEventArgs Contains data about progress changed event of the upload file.

Object Model

Syntax


Public Class UploadProgressChangedEventArgs


C#

public class UploadProgressChangedEventArgs : System.EventArgs


System.Object

System.EventArgs

C1.Silverlight.Uploader.UploadProgressChangedEventArgs

Requirements




See Also

180

Reference

UploadProgressChangedEventArgs Members


Overview Contains data about progress changed event of the upload file.

Object Model

Syntax


Public Class UploadProgressChangedEventArgs


C#

public class UploadProgressChangedEventArgs : System.EventArgs


System.Object

System.EventArgs

C1.Silverlight.Uploader.UploadProgressChangedEventArgs

Requirements




See Also

Reference



Members Properties

The following tables list the members exposed by UploadProgressChangedEventArgs.

Public Constructors

Name Description

181

UploadProgressChangedEventArgs Constructor Initializes a new instance of a

UploadProgressChangedEventArgs.

Top

Public Properties

Name Description





Top

See Also

Reference

UploadProgressChangedEventArgs Class


UploadProgressChangedEventArgs Constructor Amount of bytes that were uploaded

Amount of bytes that must be uploaded


Initializes a new instance of a UploadProgressChangedEventArgs.

Syntax



ByVal bytesUploaded As System.Long, _

ByVal totalBytesToUpload As System.Long, _

ByVal userState As System.Object _

)

C#

public UploadProgressChangedEventArgs(

182

System.long bytesUploaded,

System.long totalBytesToUpload,

System.object userState

)

Parameters

bytesUploaded

Amount of bytes that were uploaded

totalBytesToUpload

Amount of bytes that must be uploaded

userState


Requirements


Windows Server 2008 (Server Core not supported), Windows Server 2008 R2

(Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference



Properties >

Name Description





Top

See Also

Reference



183

BytesUploaded Property Amount of bytes that were uploaded.

Syntax


Public ReadOnly Property BytesUploaded As System.Long

C#

public System.long BytesUploaded {get;}

Requirements




See Also

Reference



ProgressPercentage Property Percentage of bytes that were uploaded.

Syntax


Public ReadOnly Property ProgressPercentage As System.Integer

C#

public System.int ProgressPercentage {get;}

Requirements




See Also

Reference



184

TotalBytesToUpload Property Amount of bytes that must be uploaded.

Syntax


Public ReadOnly Property TotalBytesToUpload As System.Long

C#

public System.long TotalBytesToUpload {get;}

Requirements




See Also

Reference



UserState Property Additional information attached by the user.

Syntax


Public ReadOnly Property UserState As System.Object

C#

public System.object UserState {get;}

Requirements




See Also

Reference



185

Enumerations

FilesPerRequest Specifies how files are mapped into server requests.

Syntax


Public Enum FilesPerRequest

Inherits System.Enum

C#

public enum FilesPerRequest : System.Enum

Members

Member Description

AllFilesInOneRequest All files will be uploaded in a single request. This is more

efficient when uploading many small files.

OneFilePerRequest Each request contains one file. This is the default setting.

SplitFilesIntoMultipleRequests Each file will be split into multiple requests. Indicated when

uploading very large files.


System.Object

System.ValueType

System.Enum

C1.Silverlight.Uploader.FilesPerRequest

Requirements




See Also

Reference


186

MultipartPostEncoding Specifies the encoding of the data that will be sent in the post message.

Syntax


Public Enum MultipartPostEncoding

Inherits System.Enum

C#

public enum MultipartPostEncoding : System.Enum

Members

Member Description

Base64 Data encoded in Base64 format

Binary Data encoded in binary format.


System.Object

System.ValueType

System.Enum

C1.Silverlight.Uploader.MultipartPostEncoding

Requirements




See Also

Reference


Interfaces

IUploadManager Interface implemented by classes that package files into server requests.

Object Model

187

Syntax


Public Interface IUploadManager

C#

public interface IUploadManager

Requirements




See Also

Reference

IUploadManager Members


Overview Interface implemented by classes that package files into server requests.

Object Model

Syntax


Public Interface IUploadManager

C#

public interface IUploadManager

Requirements




See Also

Reference

188




The following tables list the members exposed by IUploadManager.

Public Methods

Name Description

BeginUpload Begins the upload of one UploadFilePartPackage


Top

Public Events

Name Description

UploadCompleted Event that fires when the upload process has been completed.


Top

See Also

Reference

IUploadManager Interface


Methods >

Name Description

BeginUpload Begins the upload of one UploadFilePartPackage


Top

See Also

Reference

189



BeginUpload Method UploadManagerSettings that specify how to perform the upload.

UploadFilePartPackage that contains file parts to be uploaded.

Headers that will be sent with the upload requests.

Parameters that will be sent to the server with the upload requests.

Begins the upload of one UploadFilePartPackage

Syntax


Function BeginUpload( _






String,String) _

) As System.Boolean

C#

System.bool BeginUpload(





)

Parameters

settings

UploadManagerSettings that specify how to perform the upload.

package

UploadFilePartPackage that contains file parts to be uploaded.

headers

Headers that will be sent with the upload requests.

parameters

Parameters that will be sent to the server with the upload requests.

190

Return Value

Returns true if the upload process started successfully.

Requirements




SP2

See Also

Reference



Cancel Method Cancels the current upload process.

Syntax


Sub Cancel()

C#

void Cancel()

Requirements




See Also

Reference



Events %%scrap%%

" -->

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

Public Events

191

Name Description

UploadCompleted Event that fires when the upload process has been completed.


Top

See Also

Reference



UploadCompleted Event Event that fires when the upload process has been completed.

Syntax


Event UploadCompleted As System.EventHandler(Of UploadCompletedEventArgs)

C#

event System.EventHandler<UploadCompletedEventArgs> UploadCompleted

Event Data














192

Requirements




See Also

Reference




Syntax


Event UploadProgressChanged As System.EventHandler(Of


C#

event System.EventHandler<UploadProgressChangedEventArgs>


Event Data









Requirements




193

See Also

Reference



Delegates

C1UploaderPost.MIMETypeRequestedEventHandler Represents the method that will handle the C1UploaderPost.MIMETypeRequested event.

Syntax


Public Delegate Function C1UploaderPost.MIMETypeRequestedEventHandler( _

ByVal sender As System.Object, _

ByVal e As MIMETypeRequestedEventArgs _

) As System.String

C#

public delegate System.string C1UploaderPost.MIMETypeRequestedEventHandler(

System.object sender,

MIMETypeRequestedEventArgs e

)

Parameters

sender

e

Requirements




See Also

Reference

C1UploaderPost.MIMETypeRequestedEventHandler Members
