ZetCode

Reading a web page in C#

last modified January 4, 2023

In this article, we show how to get a web page in C#.

The article shows how to read a page using, HttpClient, Flurl.Http, and RestSharp.

Note: built-in HttpWebRequest and WebClient are obsolete, they should not be used anymore for HTTP requests.

In the examples of this tutorial, we read a web page from a small webpage webcode.me.

C# read web page with HttpClient

HttpClient provides a base class for sending HTTP requests and receiving HTTP responses from a resource identified by a URI.

Program.cs
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("User-Agent", "C# console program");

var content = await client.GetStringAsync("http://webcode.me");

Console.WriteLine(content);

The code example scrapes a web page asynchronously using the HttpClient. HttpClient is a modern way of fetching web pages in .NET. 

var content = await client.GetStringAsync("http://webcode.me");

The await operator takes an awaitable as an argument; it examines if awaitable has already completed; if the awaitable has already completed, then the method continues running. The GetStringAsync reads the content to a string as an asynchronous operation. 

$ dotnet run
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>My html page</title>
</head>
<body>

    <p>
        Today is a beautiful day. We go swimming and fishing.
    </p>

    <p>
            Hello there. How are you?
    </p>

</body>
</html>

C# read web page with Flurl.Http

Flurl.Http is a fluent, portable, testable HTTP, third-party client library for the C# language. 

$ dotnet add package Flurl.Http

We install the Flurl.Http package.

DownloadPageFlurl.cs
string result = await "http://webcode.me".GetStringAsync();
Console.WriteLine(result);

The example reads a small web page and prints its contents to the terminal. 

string result = await "http://webcode.me".GetStringAsync();

The await operator is applied to a task in an asynchronous method to suspend the execution of the method until the awaited task completes. The task represents ongoing work. The data is retrieved with the GetStringAsync extention method.

Reading a web page with RestSharp

RestSharp is a simple REST and HTTP API client for .NET. It is a third-party library. 

$ dotnet add package RestSharp

We install the RestSharp package.

Program.cs
using RestSharp;

var client = new RestClient("http://webcode.me");
var request = new RestRequest();

var res = await client.ExecuteGetAsync(request);

Console.WriteLine(res.Content);

The code example gets the contents of a web page using RestSharp library. The web page is downloaded asynchronously. 

var client = new RestClient("http://webcode.me");

A rest client is created with the RestClient class. 

var request = new RestRequest();

A request is created with RestRequest; the default is a GET request. 

var res = await client.ExecuteGetAsync(request);

The request is executed asynchronously using the ExecuteGetAsync method. 

Console.WriteLine(res.Content);

The content of the response is printed.

In this article, we have shown how to read a web page in C#.

List all C# tutorials.