Skip to content

Merge main into live #41212

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jun 2, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/core/extensions/httpclient-factory.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ ms.date: 05/19/2023

# IHttpClientFactory with .NET

In this article, you'll learn how to use the `IHttpClientFactory` to create `HttpClient` types with various .NET fundamentals, such as dependency injection (DI), logging, and configuration. The <xref:System.Net.Http.HttpClient> type was introduced in .NET Framework 4.5, which was released in 2012. In other words, it's been around for a while. `HttpClient` is used for making HTTP requests and handling HTTP responses from web resources identified by a <xref:System.Uri>. The HTTP protocol makes up the vast majority of all internet traffic.
In this article, you'll learn how to use the `IHttpClientFactory` interface to create `HttpClient` types with various .NET fundamentals, such as dependency injection (DI), logging, and configuration. The <xref:System.Net.Http.HttpClient> type was introduced in .NET Framework 4.5, which was released in 2012. In other words, it's been around for a while. `HttpClient` is used for making HTTP requests and handling HTTP responses from web resources identified by a <xref:System.Uri>. The HTTP protocol makes up the vast majority of all internet traffic.

With modern application development principles driving best practices, the <xref:System.Net.Http.IHttpClientFactory> serves as a factory abstraction that can create `HttpClient` instances with custom configurations. <xref:System.Net.Http.IHttpClientFactory> was introduced in .NET Core 2.1. Common HTTP-based .NET workloads can take advantage of resilient and transient-fault-handling third-party middleware with ease.

Expand Down
15 changes: 14 additions & 1 deletion docs/core/tools/telemetry.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ The telemetry feature collects the following data:
| >=5.0.100 | Hashed RuntimeIdentifier used for build (MSBuild property) |
| >=5.0.100 | Hashed SelfContained used for build (MSBuild property) |
| >=5.0.100 | Hashed UseApphost used for build (MSBuild property) |
| >=5.0.100 | Hashed OutputType used for build (MSBuild property |
| >=5.0.100 | Hashed OutputType used for build (MSBuild property) |
| >=5.0.201 | Hashed PublishReadyToRun used for build (MSBuild property) |
| >=5.0.201 | Hashed PublishTrimmed used for build (MSBuild property) |
| >=5.0.201 | Hashed PublishSingleFile used for build (MSBuild property) |
Expand All @@ -93,6 +93,19 @@ The telemetry feature collects the following data:
| >=6.0.300 | If the CLI was invoked from a Continuous Integration environment. For more information, see [Continuous Integration Detection](#continuous-integration-detection).|
| >=7.0.100 | Hashed PublishAot used for build (MSBuild property) |
| >=7.0.100 | Hashed PublishProtocol used for build (MSBuild property) |
| >=8.0.100 | Hashed TargetPlatformIdentifier used for build (MSBuild property) |
| >=8.0.100 | Hashed HybridGlobalization used for build (MSBuild property) |
| >=8.0.100 | Whether .NET Blazor WebAssembly SDK is used. |
| >=8.0.100 | Whether .NET WebAssembly SDK is used. |
| >=8.0.100 | Whether .NET MAUI is used. |
| >=8.0.100 | Whether .NET mobile SDK is used. |
| >=8.0.100 | Whether other mobile SDKs are used (like: Avalonia, Uno). |
| >=8.0.100 | Whether Mono AOT is used. |
| >=8.0.100 | Whether Mono AOT strip IL feature is used. |
| >=8.0.100 | Whether Mono interpreter is used. |
| >=8.0.100 | Whether library mode for mobile is used. |
| >=8.0.100 | Whether NativeAOT is used. |
| >=8.0.100 | Used Mono runtime pack version. |

### Collected options

Expand Down
2 changes: 1 addition & 1 deletion docs/standard/choosing-core-framework-server.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ There are two supported [.NET implementations](glossary.md#implementation-of-net

| Implementation | Included versions |
| - | - |
| .NET | .NET Core 1.0 - 3.1, .NET 5, and later versions of .NET. |
| .NET | .NET Core 1.0 - 3.1 </br> .NET 5 and later versions |
| .NET Framework | .NET Framework 1.0 - 4.8 |

Both share many of the same components, and you can share code across the two. However, there are fundamental differences between the two, and your choice depends on what you want to accomplish. This article provides guidance on when to use each.
Expand Down
28 changes: 14 additions & 14 deletions docs/standard/runtime-libraries-overview.md
Original file line number Diff line number Diff line change
@@ -1,33 +1,33 @@
---
title: Runtime libraries overview
description: Learn what is included in the Runtime libraries section of the table of contents.
ms.date: 08/24/2021
ms.date: 05/30/2024
---
# Runtime libraries overview

The [.NET runtime](../core/introduction.md) has an expansive standard set of class libraries, known as [runtime libraries](glossary.md#runtime), [framework libraries](glossary.md#framework-libraries), or the [base class library (BCL)](glossary.md#bcl). In addition, there are extensions to the runtime libraries, provided in NuGet packages.
The [.NET runtime](../core/introduction.md) has an expansive standard set of class libraries, known as [runtime libraries](glossary.md#runtime), [framework libraries](glossary.md#framework-libraries), or the [base class library (BCL)](glossary.md#bcl). In addition, there are extensions to the runtime libraries, which are provided in NuGet packages.

These libraries provide implementations for many general and app-specific types, algorithms, and utility functionality.

## Runtime libraries

These libraries provide the foundational types and utility functionality and are the base of all other .NET class libraries. An example is the <xref:System.String?displayProperty=nameWithType> class, which provides APIs for working with strings. Another example is the [serialization libraries](serialization/index.md).
The runtime libraries provide the foundational types and utility functionality and are the base of all other .NET class libraries. An example is the <xref:System.String?displayProperty=nameWithType> class, which provides APIs for working with strings. Another example is the [serialization libraries](serialization/index.md).

## Extensions to the runtime libraries

Some libraries are provided in NuGet packages rather than included in the runtime's [shared framework](glossary.md#shared-framework). For example:
Some libraries are provided in NuGet packages rather than as part of the runtime's [shared framework](glossary.md#shared-framework). These libraries are often made available to apps that target downlevel .NET versions, such as .NET Framework, as well.

| Conceptual content | NuGet package |
|--------------------------------------------------------------------|-------------------------------------------------------|
| [Configuration](../core/extensions/configuration.md) | [`Microsoft.Extensions.Configuration`][configuration] |
| [Dependency injection](../core/extensions/dependency-injection.md) | [`Microsoft.Extensions.DependencyInjection`][di] |
| [File globbing](../core/extensions/file-globbing.md) | [`Microsoft.Extensions.FileSystemGlobbing`][fsg] |
| [Generic Host](../core/extensions/generic-host.md) | [`Microsoft.Extensions.Hosting`][host] |
| [HTTP](../core/extensions/httpclient-factory.md) | <sup>†</sup> [`Microsoft.Extensions.Http`][http] |
| [Localization](../core/extensions/localization.md) | [`Microsoft.Extensions.Localization`][loc] |
| [Logging](../core/extensions/logging.md) | [`Microsoft.Extensions.Logging`][log] |
The following table shows some examples of package-provided libraries.

<sup>†</sup> For some target frameworks, including `net6.0`, these libraries are part of the shared framework and don't need to be installed separately.
| NuGet package | Conceptual content |
|-------------------------------------------------------|--------------------------------------------------------------------|
| [`Microsoft.Extensions.Configuration`][configuration] | [Configuration](../core/extensions/configuration.md) |
| [`Microsoft.Extensions.DependencyInjection`][di] | [Dependency injection](../core/extensions/dependency-injection.md) |
| [`Microsoft.Extensions.FileSystemGlobbing`][fsg] | [File globbing](../core/extensions/file-globbing.md) |
| [`Microsoft.Extensions.Hosting`][host] | [Generic Host](../core/extensions/generic-host.md) |
| [`Microsoft.Extensions.Http`][http] | [HTTP](../core/extensions/httpclient-factory.md) |
| [`Microsoft.Extensions.Localization`][loc] | [Localization](../core/extensions/localization.md) |
| [`Microsoft.Extensions.Logging`][log] | [Logging](../core/extensions/logging.md) |

[configuration]: https://www.nuget.org/packages/Microsoft.Extensions.Configuration
[di]: https://www.nuget.org/packages/Microsoft.Extensions.DependencyInjection
Expand Down
Loading