WebClient Constructor

Initializes a new instance of the WebClient class.

[Visual Basic]
Public Sub New()
[C#]
public WebClient();
[C++]
public: WebClient();
[JScript]
public function WebClient();

Remarks

The default constructor creates a new instance of the WebClient class with each field set to a null reference (Nothing in Visual Basic).

Example

[Visual Basic, C#, C++] The following example creates a WebClient instance and then uses it to download data from a server and display it on the system console, to download data from a server and write it to a file, and to upload form values to a server and receive the response.

[Visual Basic] 
Public Shared Sub Main()


    Try
        Dim client As New WebClient()
        Dim pageData As [Byte]() = client.DownloadData("http://www.contoso.com")
        Dim pageHtml As String = Encoding.ASCII.GetString(pageData)

        ' Download the data to a buffer.
        Console.WriteLine(pageHtml)
        
        ' Download the data to a file.
        client.DownloadFile("http://www.contoso.com", "page.htm")
        
        
        ' Upload some form post values.
        dim form as New NameValueCollection()
           form.Add("MyName", "MyValue")  

           ' Note that you need to replace "http://localhost/somefile.aspx" with the name of 
           ' a file that is available to your computer.
           Dim responseData As [Byte]() = client.UploadValues("http://www.contoso.com/form.aspx", form)      
        Console.WriteLine(Encoding.ASCII.GetString(responseData))
    
    Catch webEx As WebException
        if webEx.Status = WebExceptionStatus.ConnectFailure then
           Console.WriteLine("Are you behind a firewall?  If so, go through the proxy server.")
        end if
        Console.Write(webEx.ToString())
    End Try
    

End Sub 'Main

[C#] 
try {
    
// Download the data to a buffer.
       WebClient client = new WebClient();

  Byte[] pageData = client.DownloadData("http://www.contoso.com");
string pageHtml = Encoding.ASCII.GetString(pageData);
Console.WriteLine(pageHtml);

// Download the data to a file.
        client.DownloadFile("http://www.contoso.com", "page.htm");

// Upload some form post values.
NameValueCollection form = new NameValueCollection();        
form.Add("MyName", "MyValue");        
Byte[] responseData = client.UploadValues("http://www.contoso.com/form.aspx", form);        

}
catch (WebException webEx) {
      Console.WriteLine(webEx.ToString());
       if(webEx.Status == WebExceptionStatus.ConnectFailure) {
           Console.WriteLine("Are you behind a firewall?  If so, go through the proxy server.");
       }
}

[C++] 
try {

    // Download the data to a buffer.
    WebClient* client = new WebClient();

    Byte pageData[] = client->DownloadData(S"http://www.contoso.com");
    String* pageHtml = Encoding::ASCII->GetString(pageData);
    Console::WriteLine(pageHtml);

    // Download the data to a file.
    client->DownloadFile(S"http://www.contoso.com", S"page.htm");

    // Upload some form post values.
    NameValueCollection* form = new NameValueCollection();        
    form->Add(S"MyName", S"MyValue");        
    Byte responseData[] = client->UploadValues(S"http://www.contoso.com/form.aspx", form);        

}
catch (WebException* webEx) {
    Console::WriteLine(webEx->ToString());
    if(webEx->Status == WebExceptionStatus::ConnectFailure) {
        Console::WriteLine(S"Are you behind a firewall?  If so, go through the proxy server.");
    }
}

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Common Language Infrastructure (CLI) Standard

See Also

WebClient Class | WebClient Members | System.Net Namespace