How Do I...? Common Tasks QuickStart Tutorial

This sample illustrates how to use the WebRequest and WebResponse classes to make a GET request on a URI with NTLM authentication.

This sample is very similar to the clientGET sample. The difference is in the addition of the NetworkCredential object to handle setting a username, password, and domain to allow for NTLM authentication. Other authentication types (Basic, Digest, Kerberos and Negotiate) are also just as easy. A NetworkCredential object can be initialized with a username and password or when required, a username, password and domain. The object is then attached to the WebRequest object's Credentials property.

The function GetPage is where the specific details of making the request can be found. The rest of the code in this sample is for taking command-line parameters as well as displaying help usage for the parameters. This sample program is a command-line utility that runs at the command prompt.

The GetPage function takes a string parameter, which is the URL (or URI) of the web page to request. This URI is then included as a parameter in a call to WebRequest.Create which creates a WebRequest object.

The GetResponse function of the WebRequest object is then used to get a WebResponse object. This object can be used to get the status code of the response, as well as the actual response stream (a web page, for instance).

Writing out the stream can take several different forms. This example uses a StreamReader instance to read 256 characters into a character array. It then creates a String from the character array and writes out the String using Console.WriteLine.