System.Net.Http.WinHttpHandler 8.0.2

Prefix Reserved
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package System.Net.Http.WinHttpHandler --version 8.0.2                
NuGet\Install-Package System.Net.Http.WinHttpHandler -Version 8.0.2                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="System.Net.Http.WinHttpHandler" Version="8.0.2" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add System.Net.Http.WinHttpHandler --version 8.0.2                
#r "nuget: System.Net.Http.WinHttpHandler, 8.0.2"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install System.Net.Http.WinHttpHandler as a Cake Addin
#addin nuget:?package=System.Net.Http.WinHttpHandler&version=8.0.2

// Install System.Net.Http.WinHttpHandler as a Cake Tool
#tool nuget:?package=System.Net.Http.WinHttpHandler&version=8.0.2                

About

This package provides an HttpMessageHandler implementation backed by Windows HTTP Services (WinHTTP). While the use of the default HttpClientHandler is highly recommended for applications targeting modern .NET, WinHttpHandler might help migration scenarios by providing an alternative HTTP backend for Windows that works consistently accross .NET Framework and modern .NET.

Key Features

  • Enables sending asynchronous HTTP requests with HttpClient on Windows.
  • Handles authentication and credentials.
  • Exposes a subset of WinHTTP options as C# properties on WinHttpHandler.
  • Use custom proxy.
  • Handle cookies.

How to Use

using System.Net;

using WinHttpHandler handler = new()
{
    ServerCredentials = new NetworkCredential("usr", "pwd")
};

using HttpClient client = new(handler);
using HttpRequestMessage request = new(HttpMethod.Get, "https://httpbin.org/basic-auth/usr/pwd");
using HttpResponseMessage response = await client.SendAsync(request);

Console.WriteLine($"Status: {response.StatusCode}");
if (response.IsSuccessStatusCode)
{
    string content = await response.Content.ReadAsStringAsync();
    Console.WriteLine(content);
}

Main Types

The main types provided by this library are:

  • System.Net.Http.WinHttpHandler

Additional Documentation

Feedback & Contributing

System.Net.Http.WinHttpHandler is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETFramework 4.6.2

  • .NETStandard 2.0

    • No dependencies.
  • net6.0

    • No dependencies.
  • net7.0

    • No dependencies.
  • net8.0

    • No dependencies.

NuGet packages (85)

Showing the top 5 NuGet packages that depend on System.Net.Http.WinHttpHandler:

Package Downloads
Grpc.Net.Client

.NET client for gRPC

Microsoft.Graph.Core

Microsoft Graph Core Client Library implements core functionality used by Microsoft Graph client libraries.

Microsoft.Azure.DocumentDB

Please note, a newer package, Microsoft.Azure.Cosmos, is available. While this package will continue to receive critical bug fixes, we strongly encourage you to upgrade. See https://aka.ms/migrate-to-cosmos-dotnet-v3 for more details. This client library enables client applications to connect to Azure Cosmos DB via the NoSQL API. Azure Cosmos DB is a globally distributed, multi-model database service.

VaultSharp

The most comprehensive .NET Library for HashiCorp's Vault which is a modern secret management system. * VaultSharp supports all Auth methods, all Secrets Engines and most System Apis supported by Vault. * VaultSharp has first class support for Consul and Enterpise Vault APIs etc. * Enterprise APIs like Control Groups, Transform Secrets Engine & KMIP Secrets Engine etc. This library is built with .NET Standard 2.0, .NET Standard 2.1, 4.6.2, 4.7.2*, 4.8, .NET 6 & .NET 7 and hence is cross-platform across .NET Core 2.x, 3.x, .NET Frameworks 4.x, Xamarin iOS, Android, Mac, UWP etc.

Microsoft.Kiota.Http.HttpClientLibrary

Kiota Http provider implementation for dotnet with HttpClient.

GitHub repositories (31)

Showing the top 5 popular GitHub repositories that depend on System.Net.Http.WinHttpHandler:

Repository Stars
PowerShell/PowerShell
PowerShell for every system!
dotnet/runtime
.NET is a cross-platform runtime for cloud, mobile, desktop, and IoT apps.
win-acme/win-acme
A simple ACME client for Windows (for use with Let's Encrypt et al.)
grpc/grpc-dotnet
gRPC for .NET
aspnet/KestrelHttpServer
[Archived] A cross platform web server for ASP.NET Core. Project moved to https://github.com/aspnet/AspNetCore
Version Downloads Last updated
9.0.0-preview.7.24405.7 147 8/13/2024
9.0.0-preview.6.24327.7 861 7/9/2024
9.0.0-preview.5.24306.7 344 6/11/2024
9.0.0-preview.4.24266.19 461 5/21/2024
9.0.0-preview.3.24172.9 3,782 4/11/2024
9.0.0-preview.2.24128.5 420 3/12/2024
9.0.0-preview.1.24080.9 5,616 2/13/2024
8.0.2 3,282 8/13/2024
8.0.1 63,847 7/9/2024
8.0.0 1,357,648 11/14/2023
8.0.0-rc.2.23479.6 4,388 10/10/2023
8.0.0-rc.1.23419.4 3,520 9/12/2023
8.0.0-preview.7.23375.6 4,709 8/8/2023
8.0.0-preview.6.23329.7 833 7/11/2023
8.0.0-preview.5.23280.8 2,050 6/13/2023
8.0.0-preview.4.23259.5 4,550 5/16/2023
8.0.0-preview.3.23174.8 7,216 4/11/2023
8.0.0-preview.2.23128.3 1,784 3/14/2023
8.0.0-preview.1.23110.8 3,325 2/21/2023
7.0.0 3,793,080 11/7/2022
7.0.0-rc.2.22472.3 3,191 10/11/2022
7.0.0-rc.1.22426.10 5,113 9/14/2022
7.0.0-preview.7.22375.6 4,431 8/9/2022
7.0.0-preview.6.22324.4 889 7/12/2022
7.0.0-preview.5.22301.12 1,621 6/14/2022
7.0.0-preview.4.22229.4 4,747 5/10/2022
7.0.0-preview.3.22175.4 3,936 4/13/2022
7.0.0-preview.2.22152.2 5,699 3/14/2022
7.0.0-preview.1.22076.8 1,424 2/17/2022
6.0.1 5,436,388 4/12/2022
6.0.0 2,518,157 11/8/2021
6.0.0-rc.2.21480.5 1,787 10/12/2021
6.0.0-rc.1.21451.13 62,950 9/14/2021
6.0.0-preview.7.21377.19 3,862 8/10/2021
6.0.0-preview.6.21352.12 4,881 7/14/2021
6.0.0-preview.5.21301.5 1,409 6/15/2021
6.0.0-preview.4.21253.7 23,173 5/24/2021
6.0.0-preview.3.21201.4 26,578 4/8/2021
6.0.0-preview.2.21154.6 4,138 3/11/2021
6.0.0-preview.1.21102.12 21,918 2/12/2021
5.0.0 4,496,606 11/9/2020 5.0.0 is deprecated because it is no longer maintained.
5.0.0-rc.2.20475.5 3,229 10/13/2020
5.0.0-rc.1.20451.14 1,956 9/14/2020
5.0.0-preview.8.20407.11 1,434 8/25/2020
5.0.0-preview.7.20364.11 4,322 7/21/2020
5.0.0-preview.6.20305.6 1,708 6/25/2020
5.0.0-preview.5.20278.1 1,656 6/10/2020
5.0.0-preview.4.20251.6 4,645 5/18/2020
5.0.0-preview.3.20214.6 1,319 4/23/2020
5.0.0-preview.2.20160.6 1,903 4/2/2020
5.0.0-preview.1.20120.5 2,760 3/16/2020
4.7.2 1,594,973 6/9/2020
4.7.0 7,262,329 12/3/2019
4.7.0-preview3.19551.4 3,789 11/13/2019
4.7.0-preview2.19523.17 1,843 11/1/2019
4.7.0-preview1.19504.10 4,903 10/15/2019
4.6.0 1,172,695 9/23/2019
4.6.0-rc1.19456.4 8,082 9/16/2019
4.6.0-preview9.19421.4 1,586 9/4/2019
4.6.0-preview9.19416.11 872 9/4/2019
4.6.0-preview8.19405.3 3,053 8/13/2019
4.6.0-preview7.19362.9 3,841 7/23/2019
4.6.0-preview6.19303.8 4,036 6/12/2019
4.6.0-preview6.19264.9 881 9/4/2019
4.6.0-preview5.19224.8 1,525 5/6/2019
4.6.0-preview4.19212.13 1,033 4/18/2019
4.6.0-preview3.19128.7 9,760 3/6/2019
4.6.0-preview.19073.11 2,893 1/29/2019
4.6.0-preview.18571.3 5,223 12/3/2018
4.5.4 2,621,047 5/30/2019
4.5.3 551,426 4/9/2019 4.5.3 has at least one vulnerability with high severity.
4.5.2 4,726,423 1/8/2019 4.5.2 has at least one vulnerability with high severity.
4.5.2-servicing-27114-05 3,353 11/28/2018 4.5.2-servicing-27114-05 has at least one vulnerability with high severity.
4.5.1 427,675 10/1/2018 4.5.1 has at least one vulnerability with high severity.
4.5.0 5,882,697 5/29/2018 4.5.0 has at least one vulnerability with high severity.
4.5.0-rc1 2,736 5/6/2018 4.5.0-rc1 has at least one vulnerability with high severity.
4.5.0-preview2-26406-04 3,049 4/10/2018 4.5.0-preview2-26406-04 has at least one vulnerability with high severity.
4.5.0-preview1-26216-02 19,988 2/26/2018 4.5.0-preview1-26216-02 has at least one vulnerability with high severity.
4.4.0 48,281,500 8/11/2017 4.4.0 has at least one vulnerability with high severity.
4.4.0-preview2-25405-01 16,349 6/27/2017 4.4.0-preview2-25405-01 has at least one vulnerability with high severity.
4.4.0-preview1-25305-02 7,931 5/9/2017 4.4.0-preview1-25305-02 has at least one vulnerability with high severity.
4.3.3 8,260 10/9/2018 4.3.3 has at least one vulnerability with high severity.
4.3.2 65,820 9/20/2017 4.3.2 has at least one vulnerability with high severity.
4.3.1 77,858 5/9/2017 4.3.1 has at least one vulnerability with high severity.
4.3.0 158,134 11/15/2016 4.3.0 has at least one vulnerability with high severity.
4.3.0-preview1-24530-04 13,839 10/24/2016
4.0.4 15,588 10/9/2018
4.0.3 4,730 9/20/2017
4.0.2 38,316 5/9/2017
4.0.1 17,712 12/13/2016
4.0.0 17,782,861 6/27/2016 4.0.0 has at least one vulnerability with high severity.
4.0.0-rc2-24027 9,506 5/16/2016
4.0.0-beta-23516 9,677 11/18/2015
4.0.0-beta-23409 14,784 10/15/2015
4.0.0-beta-23225 11,865 9/2/2015
4.0.0-beta-23123 3,994 7/29/2015
4.0.0-beta-23109 8,944 7/27/2015
4.0.0-beta-23019 16,037 6/30/2015
4.0.0-beta-22816 16,207 4/24/2015
4.0.0-beta-22605 5,448 2/13/2015
4.0.0-beta-22416 3,265 1/16/2015
4.0.0-beta-22231 5,982 11/11/2014