HttpVersion Class

Definition

Namespace:

System.Net

Assembly:

System.Net.Primitives.dll

Source:

HttpVersion.cs

Defines the HTTP version numbers that are supported by the HttpWebRequest and HttpWebResponse classes.

public ref class HttpVersion abstract sealed

public static class HttpVersion

type HttpVersion = class

Public Class HttpVersion

Inheritance

Object

HttpVersion

Examples

The following example demonstrates the use of HttpVersion.

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClient^ client = gcnew HttpClient();

HttpRequestMessage^ request = new HttpRequestMessage(HttpMethod::Get, "http://www.microsoft.com");
Console::WriteLine("Default HTTP request version is {0}", request.Version);

request.Version = HttpVersion.Version10;
Console::WriteLine("Request version after assignment is {0}", request.Version);

HttpResponseMessage^ response = client->Send(request);
Console::WriteLine("Response HTTP version {0}", response.Version);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
using HttpClient client = new HttpClient();

using HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Get, "http://www.microsoft.com");
Console.WriteLine("Default HTTP request version is {0}", request.Version);

request.Version = HttpVersion.Version10;
Console.WriteLine("Request version after assignment is {0}", request.Version);

using HttpResponseMessage response = client.Send(request);
Console.WriteLine("Response HTTP version {0}", response.Version);

' HttpClient lifecycle management best practices:
' https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
Using client As New HttpClient()
    Using request As New HttpRequestMessage(HttpMethod.Get, "http://www.microsoft.com")
        Console.WriteLine("Default HTTP request version is {0}", request.Version)

        request.Version = HttpVersion.Version10
        Console.WriteLine("Request version after assignment is {0}", request.Version)

        Using response As HttpResponseMessage = client.Send(request)
            Console.WriteLine("Response HTTP version {0}", response.Version)
        End Using
    End Using
End Using

Remarks

The HttpVersion class defines the HTTP versions that are supported by the HttpClient class. The HTTP version number is used to control version-specific features of HTTP, such as pipelining and chunking.

Fields

Unknown	Defines a Version instance for an unknown HTTP version.
Version10	Defines a Version instance for HTTP 1.0.
Version11	Defines a Version instance for HTTP 1.1.
Version20	Defines a Version instance for HTTP 2.0.
Version30	Defines a Version instance for HTTP 3.0.