The System.Net.WebClient class provides functionality to upload data to or download data from the Internet or intranet or a local file system. The WebClient class provides many ways to download and upload data. The following table describes WebClient class methods and properties briefly.
Member |
Type |
Description |
BaseURI |
Property |
Current base URL address |
Headers |
Property |
Headers in the form of name and value pair associated with the request. |
QueryStrings |
Property |
Queries in the form of name and value pair associated with the request. |
ResponseHeaders |
Property |
Headers in the form of name and value pair associated with the response. |
DownloadData |
Method |
Download data from a URI and returns data as a byte array. |
DownloadFile |
Method |
Download data from a URI and saves as a local file. |
OpenRead |
Method |
Opens and reads a URI in stream form. |
OpenWrite |
Method |
Opens a stream to write data to a URI. |
UploadData |
Method |
Uploads data buffer to a URI. |
UploadFile |
Method |
Uploads a local file to the given URI. |
UploadValues |
Method |
Uploads name and value collection. |
The WebClient provides three different methods to download data either from the Internet, intranet, or local file system.
WebClient constructor doesn抰 take any arguments. In the following code, URL is the file name you want to download such as http://www.c-sharpcorner.com/index.asp. You can download any type of files using these methods such as image files, html and so on.
string URL = textBox1.Text;
WebClient client = new WebClient();
The DownloadData method takes URI as a parameter, downloads data from a resource URI and returns a byte string.
byte [] bytedata = client.DownloadData(URL);
The DownloadFile method downloads data from a resource and saves it to the local file system. Hence it takes parameters, first is URI name and second is the file name stored as on the local system. The following code downloads a URL and saves it as temp.asp.
client.DownloadFile(URL, "C:\\temp.asp");
The OpenRead method downloads data from a resource and return data as a stream.
Stream data = client.OpenRead(URL);
// Address of URL while( str != null) |
The WebClient class provides four different ways to uploading data to a resource.
The OpenWrite method sends a data stream to the resource. It抯 reverse operation of OpenRead method. You pass URI as first parameter of OpenWrite.
OpenWrite(string);
The UploadData method sends a byte array to the resource and returns a byte array containing any response. It抯 a reverse operation of DownloadData method. It takes two arguments of string and array of bytes respectively.
UploadData(string, byte[]);
client.UploadData("http://www.mindcracker.com/testfile.bmp", data);
The UploadFile method sends a local file to the resource and returns a byte array containing any response. It抯 a reverse operation of DownloadFile. UploadFile also takes two parameters. First a URI name and second file to be uploaded.
UploadFile(string string);
client.UploadFile("http://www.mindcracker.com/tst.gif", @"c:\mcb.gif");
Or:
client.UploadFile("http://www.mindcracker.com/test.htm", @"c:\test.htm");
The UploadValues sends a NameValueCollection to the resource and returns a byte array containing any response.
UploadValues(string, NameValueCollection);
Although you can use WebClient class to upload and download data but there are more things involved in uploading and downloading data. What if you don抰 have right to upload to the server you are uploading to? Did you see us passing userid and passwords for the server somewhere? We didn抰 think so. So if you don抰 have permission to write to the server, you get this error.
So what we do now? That抯 where boundary of the WebClient class ends. And that抯 where the WebRequest and WebResponse classes come in the existence.
The WebRequest is an abstract base class. So you actually don抰 use it directly. You use it through it derived classes ?HttpWebRequest and FileWebRequest.
You use Create method of WebRequest to create an instance of WebRequest. GetResponseStream returns data stream. The following sample example downloads data stream from a web page.
Sample Code
using System; namespace WebRequestSamp StreamReader reader = new StreamReader(response.GetResponseStream()); string str = reader.ReadLine(); |
HttpWebRequest and HttpWebResponse classes works in same way too. Here is one sample example.
Using HttpWebRequest and HttpWebResponse Classes
HttpWebRequest request = (HttpWebRequest)WebRequest.Create ("http://www.microsoft.com "); string str = reader.ReadLine(); |