dotnet / dotnet/AspNetCore.Docs

Document guidance about when to use and not use HTTP Client Factory

Open
#11,882 8 comments 13 reactions 1 assignee Claimed by @tdykstra View on GitHub
doc-enhancement Pri1 re-Aditya
Dominant language
C#
Stars
13.1k
Forks
24.6k
Avg merge
1d 3h
Merged PRs (30d)
97

Description

We should improve the scenario guidance around HTTP client to help users understand the whens and whys of choosing to use the HTTP Client Factory.

I want a section of the doc that provides clear messaging around the topics raised by a question like: https://github.com/aspnet/Extensions/issues/1345 Users often feel like they want to use *something like* the HTTP Client Factory but also don't want to use the actual HTTP Client Factory, so they ask us to change it so they have more alternatives.

We should also include samples and guidance for using HTTP Client Factory and other Microsoft.Extensions libraries outside of ASP.NET Core. Example using Web Forms: https://github.com/glennc/httpclientfactorysample/blob/master/src/WebUI.WebForms/Global.asax.cs#L26 It's not clear to users that this is possible, and it is actually something we recommend.

Using the `Microsoft.Extensions` libraries outside of ASP.NET Core is a great way to start modernizing an older application, and has resonated really well with some users I have talked to about it.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.