System.Net.Http.WinHttpHandler
10.0.0-preview.4.25255.103
Prefix Reserved
.NET 8.0
This package targets .NET 8.0. The package is compatible with this framework or higher.
.NET Standard 2.0
This package targets .NET Standard 2.0. The package is compatible with this framework or higher.
.NET Framework 4.6.2
This package targets .NET Framework 4.6.2. The package is compatible with this framework or higher.
This is a prerelease version of System.Net.Http.WinHttpHandler.
There is a newer prerelease version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package System.Net.Http.WinHttpHandler --version 10.0.0-preview.4.25255.103
NuGet\Install-Package System.Net.Http.WinHttpHandler -Version 10.0.0-preview.4.25255.103
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="10.0.0-preview.4.25255.103" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="System.Net.Http.WinHttpHandler" Version="10.0.0-preview.4.25255.103" />
<PackageReference Include="System.Net.Http.WinHttpHandler" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add System.Net.Http.WinHttpHandler --version 10.0.0-preview.4.25255.103
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: System.Net.Http.WinHttpHandler, 10.0.0-preview.4.25255.103"
#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.
#:package System.Net.Http.WinHttpHandler@10.0.0-preview.4.25255.103
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=System.Net.Http.WinHttpHandler&version=10.0.0-preview.4.25255.103&prerelease
#tool nuget:?package=System.Net.Http.WinHttpHandler&version=10.0.0-preview.4.25255.103&prerelease
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
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 | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. 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 was computed. 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. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.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
- Microsoft.Bcl.HashCode (>= 6.0.0)
- System.Buffers (>= 4.6.1)
- System.Memory (>= 4.6.3)
-
.NETStandard 2.0
- No dependencies.
-
net10.0
- No dependencies.
-
net8.0
- No dependencies.
-
net9.0
- No dependencies.
GitHub repositories (37)
Showing the top 20 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
|
|
netwrix/pingcastle
PingCastle - Get Active Directory Security at 80% in 20% of the time
|
|
aspnet/Benchmarks
Benchmarks for ASP.NET Core
|
|
BedrockLauncher/BedrockLauncher
|
|
AlexWan/OsEngine
Open Source algo trading platform
|
|
dotnet/dotnet-api-docs
.NET API reference documentation (.NET 5+, .NET Core, .NET Framework)
|
|
mili-tan/AuroraDNS.GUI
纯净抗污染,简单轻量级
|
|
Kyrodan/KeeAnywhere
A cloud storage provider plugin for KeePass Password Safe
|
|
PlayFab/consuldotnet
.NET API for Consul (http://www.consul.io/)
|
|
chummer5a/chummer5a
Character generator for Shadowrun 5th edition
|
|
rajanadar/VaultSharp
A comprehensive cross-platform .NET Library for HashiCorp's Vault, a secret management tool
|
|
DataDog/dd-trace-dotnet
.NET Client Library for Datadog APM
|
|
apache/arrow-adbc
Database connectivity API standard and libraries for Apache Arrow
|
|
microsoft/RTVS
R Tools for Visual Studio.
|
|
Syslifters/offsec-tools
Compiled tools for internal assessments
|
|
projectkudu/ARMClient
A simple command line tool to invoke the Azure Resource Manager API
|
Version | Downloads | Last Updated |
---|---|---|
10.0.0-preview.6.25358.103 | 0 | 7/17/2025 |
10.0.0-preview.6.25321.102 | 0 | 6/25/2025 |
10.0.0-preview.5.25280.105 | 0 | 6/2/2025 |
10.0.0-preview.5.25277.114 | 0 | 6/3/2025 |
10.0.0-preview.5.25277.101 | 0 | 5/29/2025 |
10.0.0-preview.5.25266.103 | 0 | 5/20/2025 |
10.0.0-preview.4.25255.103 | 0 | 5/12/2025 |
9.0.7 | 0 | 7/11/2025 |
4.6.0-preview.19073.11 | 2 | 1/28/2019 |
4.6.0-preview.18571.3 | 1 | 11/30/2018 |
4.0.0-beta-23119 | 40 | 7/20/2015 |
4.0.0-beta-23019 | 4,230 | 6/29/2015 |
4.0.0-beta-22816 | 10,452 | 4/24/2015 |
4.0.0-beta-22605 | 1,867 | 2/13/2015 |
4.0.0-beta-22416 | 512 | 1/16/2015 |
4.0.0-beta-22231 | 1,286 | 11/11/2014 |