A Practical Guide to SharePoint 2013

A Practical Guide to SharePoint 2013
A Practical Guide to SharePoint 2013 - Book by Saifullah Shafiq

Thursday, November 30, 2006

WSUploadService - Web Service for uploading documents into SharePoint

WSUploadService - Web Service for uploading documents into SharePoint

WSUploadService - Web Service for uploading documents into SharePoint
Category: MOSS 2007, WSS 3.0
WS UploadService is a web service written for Microsoft Office SharePoint Server 2007 and Windows SharePoint Services 3.0 and is meant for uploading documents into SharePoint. I have just uploaded the zip file to GotDotNet.com so it will take some time before the zip file appears in the list of downloads. For the time being, you can download the zip file from the following location:
http://www.walisystems.com/ws1_dlc.asp (Download Size: 361 KB)
The zip file contains the web service and its related files. It also contains an installer to help you install the service easily on your server. Unzip the file to your hard disk. It will create a "WSUploadService" folder. You can unzip the file anywhere on your hard disk. There is no restriction on unzipping it to a particular folder. Run "UploadServiceCopier.exe" to install the service. Installer will ask you to select a SharePoint site where this service should be installed. Select your site from the drop down and keep the folder name as "bin" (second field: textbox) and click "Next".

To uninstall, run the "UploadServiceCopier.exe" again. It will give you the following message:

"Service is already installed. Do you want to uninstall it?"

Select "Yes" and then select "Remove WSUploadService" and click "Finish" to uninstall the service. Uninstall will remove all copied files from your hard disk.

Point to remember:

1. Please run "UploadServiceCopier.exe" to install/uninstall the service. Do not run "setup.exe" directly as it will not install the service correctly.

Sample Application:          

Following is a C# sample demonstrating the use of this web service.

1. Create a .NET application.
2. Add a web reference to the web service installed on your server. For example, if you installed the web service on your default port (80), then use following url to access the web service:


If you installed the service on another port, for example, port 17316, then the url will be:


You can also browse all web services available on the server. Files.asmx will be listed in the web services available on the server. There will be multiple entries, each entry representing the service available for a different web application. Therefore, if you want to upload documents to a site on port 80, then you should select Files.asmx for port 80.

3. Add following code to your application:

localhost.Files oUploader = new localhost.Files();

oUploader.PreAuthenticate = true;
oUploader.Credentials = CredentialCache.DefaultCredentials;

string strPath = @"C: est.doc";
string strFile = strPath.Substring(strPath.LastIndexOf("\") + 1);

string strDestination = "http://sp:17316/Docs";

FileStream fStream = new FileStream(strPath, System.IO.FileMode.Open);
byte[] binFile = new byte[(int)fStream.Length];
fStream.Read(binFile, 0, (int)fStream.Length);

string str = oUploader.UploadDocument(strFile, binFile, strDestination);

catch (Exception ex)
MessageBox.Show(ex.Source + " - " + ex.Message + " - " + ex.InnerException + " - " + ex.StackTrace);

localhost is the name of the web reference that you added in previous step.

4. Run the application to test the service. "strPath" contains the filename that is to be uploaded. This is just a sample to show you how the service works, that's why i have hard coded the filename but in a real life situation you may want to add a text box and a browse button to select files from your hard disk. "strDestination" contains the destination path. This should be the path representing the document library where file is to be uploaded.

5. Finally, before testing the service, make sure the current user has privileges to upload documents in the destination document library. The user should have "Contributor" rights in the document library otherwise, you will get "401: Unauthorized" error.

Please feel free to send your comments and feedback and keep visiting the blog for more detail on the web service.

Thank you,

S.S. Ahmed

SharePoint Tags: http://del.icio.us/sharepoint
Published Thursday, November 30, 2006 4:07 PM by ssa

Comment Notification

If you would like to receive an email when updates are made to this post, please register here
Subscribe to this post's comments using RSS



All About SharePoint said:

December 6, 2006 8:54 AM

All About SharePoint said:

WS Upload Service Demo Using ASP.NET AJAX 1.0 Beta 2

You can download WS UploadService 1.0...
December 7, 2006 11:47 AM

ssa said:

Dear Sahridhayan,

Thanks for your email. The web service must be installed on the server that hosts SharePoint. Because you are trying to add a document to a library on virtual PC1 therefore, web service must be installed on virtual PC1. You can access this web service from any other machine (client). Be it Win 2003 or XP!

Hope this helps!


December 17, 2006 5:56 AM

Sahridhayan said:


Yes, i have my VPC2 installed with WSS 3.0 since i am able to execute  Share point Object model, is that not enough to connect to another sharepoint server using the same web service?

December 17, 2006 8:55 AM

ssa said:


Since you are trying to upload the document to VPC1, therefore, web service must be installed on VPC1.


December 26, 2006 2:41 AM

Sahridhayan said:

Due to some constraint i cannot have web service and SP(production) in single place, cannot i access SP from with in another WS (where WSS3.0) installed?

January 3, 2007 2:22 AM

ssa said:


Of course, you can access SP from any web service but that web service must be running on the server. This is what web services are for. You can access SP from remote machines using web services.
January 10, 2007 4:46 AM

No comments:

Post a Comment