Merge pull request #44521 from dotnet/main

Merge main into live

Author: dotnet-policy-service[bot]

api/index.md

@@ -4,11 +4,11 @@ layout: ApiBrowserPage
 hide_bc: true
 title: .NET API browser
 quickFilterColumn1: net-9.0,netframework-4.8.1,netstandard-2.1
-quickFilterColumn2: aspnetcore-9.0,efcore-8.0,net-maui-9.0
-quickFilterColumn3: azure-dotnet,ml-dotnet,spark-dotnet
+quickFilterColumn2: aspnetcore-9.0,dotnet-aspire-9.0,net-maui-9.0
+quickFilterColumn3: efcore-9.0,azure-dotnet,ml-dotnet
 ms.topic: landing-page
 ms.custom: "updateeachrelease"
-ms.date: 11/10/2024
+ms.date: 01/23/2025
 ---
 # .NET API browser
 

docfx.json

@@ -633,6 +633,7 @@
                 "_csharplang/proposals/csharp-9.0/target-typed-new.md": "Target-typed new expressions",
                 "_csharplang/proposals/csharp-9.0/top-level-statements.md": "Top-level statements",
                 "_csharplang/proposals/csharp-9.0/unconstrained-type-parameter-annotations.md": "Unconstrained type parameter annotations",
+                "_csharplang/proposals/csharp-9.0/variance-safety-for-static-interface-members.md": "Variance safety for static interface members",
                 "_csharplang/proposals/csharp-10.0/record-structs.md": "Record structs",
                 "_csharplang/proposals/csharp-10.0/parameterless-struct-constructors.md": "Parameterless struct constructors",
                 "_csharplang/proposals/csharp-10.0/GlobalUsingDirective.md": "Global using directive",
@@ -752,7 +753,8 @@
                 "_csharplang/proposals/csharp-9.0/target-typed-conditional-expression.md": "This feature specification describes syntax rules to find a best match for the target of a conditional expression (?:).",
                 "_csharplang/proposals/csharp-9.0/target-typed-new.md": "This feature specification describes the enhancements to 'new' where the target type can be inferred from the variable declaration.",
                 "_csharplang/proposals/csharp-9.0/top-level-statements.md": "This feature specification describes top-level statements, which are program statements that replace the typical 'Main' method enclosed in a startup class.",
-                "_csharplang/proposals/csharp-9.0/unconstrained-type-parameter-annotations.md": "This feature specification unconstrained type parameter annotations. This enables 'T?' to be used where 'T' is not constrained to be either a value type or a reference type.",
+                "_csharplang/proposals/csharp-9.0/unconstrained-type-parameter-annotations.md": "This feature specification describes unconstrained type parameter annotations. This enables 'T?' to be used where 'T' is not constrained to be either a value type or a reference type.",
+                "_csharplang/proposals/csharp-9.0/variance-safety-for-static-interface-members.md": "This feature specification describes variance safety for static interface members",
                 "_csharplang/proposals/csharp-10.0/record-structs.md": "This feature specification describes record structs, which are structs where the compiler generates methods similar to those for record classes.",
                 "_csharplang/proposals/csharp-10.0/parameterless-struct-constructors.md": "This feature specification parameterless struct constructors, which can now be declared for structs. The rules for when they are called describe behavior in arrays and other variable declarations.",
                 "_csharplang/proposals/csharp-10.0/GlobalUsingDirective.md": "This feature specification describes global using directives, which add a using directive to every file compiled as part of an assembly.",

docs/architecture/blazor-for-web-forms-developers/data.md

@@ -1,7 +1,7 @@
 ---
 title: Data access and management
 description: Learn how to access and handle data in ASP.NET Web Forms and Blazor.
-author: csharpfritz    
+author: csharpfritz
 ms.author: jefritz
 no-loc: [Blazor]
 ms.date: 04/11/2022
@@ -48,7 +48,7 @@ public class Product
 }
 ```
 
-Product has a primary key and three additional fields that would be created in our database:  
+Product has a primary key and three additional fields that would be created in our database:
 
 - EF will identify the `Id` property as a primary key by convention.
 - `Name` will be stored in a column configured for text storage. The `[Required]` attribute decorating this property will add a `not null` constraint to help enforce this declared behavior of the property.
@@ -105,9 +105,9 @@ When ASP.NET was first released, SOAP services were the preferred way for web se
 builder.Services.AddHttpClient("github", client =>
 {
     client.BaseAddress = new Uri("http://api.github.com/");
-    // Github API versioning
+    // GitHub API versioning
     client.DefaultRequestHeaders.Add("Accept", "application/vnd.github.v3+json");
-    // Github requires a user-agent
+    // GitHub requires a user-agent
     client.DefaultRequestHeaders.Add("User-Agent", "BlazorWebForms-Sample");
 });
 ```

docs/architecture/maui/unit-testing.md

@@ -14,7 +14,7 @@ Multi-platform apps experience problems similar to both desktop and web-based ap
 
 A unit test takes a small unit of the app, typically a method, isolates it from the remainder of the code, and verifies that it behaves as expected. Its goal is to check that each unit of functionality performs as expected, so errors don't propagate throughout the app. Detecting a bug where it occurs is more efficient than observing the effect of a bug indirectly at a secondary point of failure.
 
-Unit testing has the most significant effect on code quality when it's an integral part of the software development workflow. Unit tests can act as design documentation and functional specifications for an application. As soon as a method has been written, unit tests should be written that verify the method's behavior in response to standard, boundary, and incorrect input data cases and check any explicit or implicit assumptions made by the code. Alternatively, with test-driven development, unit tests are written before the code. For more information on test-driven development and how to implement it, see [Walkthrough: Test-driven development using Test Explorer.](/visualstudio/test/quick-start-test-driven-development-with-test-explorer)
+Unit testing has the most significant effect on code quality when it's an integral part of the software development workflow. Unit tests can act as design documentation and functional specifications for an application. As soon as a method has been written, unit tests should be written that verify the method's behavior in response to standard, boundary, and incorrect input data cases and check any explicit or implicit assumptions made by the code. Alternatively, with test-driven development, unit tests are written before the code. For more information on test-driven development and how to implement it, see [Walkthrough: Test-driven development using Test Explorer.](/visualstudio/test/quick-start-test-driven-development-with-test-explorer).
 
 > [!NOTE]
 > Unit tests are very effective against regression. That is, functionality that used to work, but has been disturbed by a faulty update.

docs/architecture/microservices/container-docker-introduction/docker-defined.md

@@ -70,7 +70,7 @@ The system is simple:
 
 So, simplifying, that's the core idea of Docker.
 
-In Docker, each layer is the resulting set of changes that happen to the filesystem after executing a command, such as, installing a program.
+In Docker, each layer is the resulting set of changes that happen to the filesystem after executing a command, such as installing a program.
 
 So, when you "look" at the filesystem after the layer has been copied, you see all the files, included in the layer when the program was installed.
 

docs/architecture/microservices/implement-resilient-applications/use-httpclientfactory-to-implement-resilient-http-requests.md

@@ -1,6 +1,6 @@
 ---
 title: Use IHttpClientFactory to implement resilient HTTP requests
-description: Learn how to use IHttpClientFactory, available since .NET Core 2.1, for creating `HttpClient` instances, making it easy for you to use it in your applications. 
+description: Learn how to use IHttpClientFactory, available since .NET Core 2.1, for creating `HttpClient` instances, making it easy for you to use it in your applications.
 ms.date: 01/13/2021
 ---
 # Use IHttpClientFactory to implement resilient HTTP requests
@@ -54,7 +54,7 @@ There are several ways that you can use `IHttpClientFactory` in your application
 For the sake of brevity, this guidance shows the most structured way to use `IHttpClientFactory`, which is to use Typed Clients (Service Agent pattern). However, all options are documented and are currently listed in this [article covering the `IHttpClientFactory` usage](/aspnet/core/fundamentals/http-requests#consumption-patterns).
 
 > [!NOTE]
-> If your app requires cookies, it might be better to avoid using <xref:System.Net.Http.IHttpClientFactory> in your app. For alternative ways of managing clients, see [Guidelines for using HTTP clients](../../../fundamentals/networking/http/httpclient-guidelines.md)
+> If your app requires cookies, it might be better to avoid using <xref:System.Net.Http.IHttpClientFactory> in your app. For alternative ways of managing clients, see [Guidelines for using HTTP clients](../../../fundamentals/networking/http/httpclient-guidelines.md).
 
 ## How to use Typed Clients with IHttpClientFactory
 
@@ -191,19 +191,19 @@ Up to this point, the above code snippet only shows the example of performing re
 
 ## Additional resources
 
-- **HttpClient guidelines for .NET**  
+- **HttpClient guidelines for .NET**
   [https://learn.microsoft.com/en-us/dotnet/fundamentals/networking/http/httpclient-guidelines](../../../fundamentals/networking/http/httpclient-guidelines.md)
 
-- **Using HttpClientFactory in .NET**  
+- **Using HttpClientFactory in .NET**
   [https://learn.microsoft.com/en-us/dotnet/core/extensions/httpclient-factory](../../../core/extensions/httpclient-factory.md)
 
-- **Using HttpClientFactory in ASP.NET Core**  
+- **Using HttpClientFactory in ASP.NET Core**
   [https://learn.microsoft.com/aspnet/core/fundamentals/http-requests](/aspnet/core/fundamentals/http-requests)
 
-- **HttpClientFactory source code in the `dotnet/runtime` GitHub repository**  
+- **HttpClientFactory source code in the `dotnet/runtime` GitHub repository**
   <https://github.com/dotnet/runtime/tree/release/7.0/src/libraries/Microsoft.Extensions.Http/>
 
-- **Polly (.NET resilience and transient-fault-handling library)**  
+- **Polly (.NET resilience and transient-fault-handling library)**
   <https://thepollyproject.azurewebsites.net/>
 
 >[!div class="step-by-step"]

docs/azure/key-azure-services.md

@@ -22,8 +22,8 @@ While Azure contains over 100 services, the following Azure services are the ser
 | ![Azure Service Bus Icon](./media/service-bus.svg) | **Azure Service Bus**   | Azure Service Bus is a fully managed enterprise message broker supporting both point to point and publish-subscribe integrations.  It is ideal for building decoupled applications, queue based load leveling, or facilitating communication between microservices.   |
 | ![Azure Key Vault Icon](./media/azure-key-vault.svg) | **Azure Key Vault**   | Every application has application secrets like connection strings and API keys it must store.  Azure Key Vault helps you store and access those secrets securely, in an encrypted vault with restricted access to make sure your secrets and your application are not compromised.   |
 
-For the full list of Azure products and services, visit the [Azure documentation home page](/azure/?product=all)
+For the full list of Azure products and services, visit the [Azure documentation home page](/azure/?product=all).
 
-### Next steps
+## Next steps
 
-Start configuring your Azure development environment by [Creating an Azure Account](create-azure-account.md)
+Start configuring your Azure development environment by [Creating an Azure Account](create-azure-account.md).

docs/azure/migration/vm.md

@@ -52,7 +52,7 @@ Azure Virtual Networks enable you to:
 - Connect your VM to your on-premises network using one of several [connectivity options](/azure/vpn-gateway/vpn-gateway-about-vpngateways#s2smulti)
 - Integrate your virtual machine into your on-premises network using [ExpressRoute](https://azure.microsoft.com/services/expressroute/)
 
-To get started, see the [Virtual Network documentation](/azure/virtual-network/)
+To get started, see the [Virtual Network documentation](/azure/virtual-network/).
 
 ### Active Directory
 

docs/azure/sdk/resource-management.md

@@ -18,13 +18,13 @@ Those packages follow the [new Azure SDK guidelines](https://azure.github.io/azu
 - Distributed tracing.
 
 > [!NOTE]
-> You may notice that some packages are still pre-release version, phased releases of additional Azure services' management plane libraries are in process. If you are looking for a stable version package for a particular azure resource and currently only a pre-release version is available, please raise an issue in [Azure SDK for .NET Github repo](https://github.com/Azure/azure-sdk-for-net/issues/new?assignees=&labels=&template=02_feature_request.yml&title=%5BFEATURE+REQ%5D)
+> You might notice that some packages are still prerelease version. Phased releases of additional Azure services' management plane libraries are in process. If you're looking for a stable version package for a particular Azure resource and currently only a prerelease version is available, please raise an issue in [Azure SDK for .NET GitHub repo](https://github.com/Azure/azure-sdk-for-net/issues/new?assignees=&labels=&template=02_feature_request.yml&title=%5BFEATURE+REQ%5D).
 
 ## Get started
 
 ### Prerequisites
 
-- An [Azure subscription](https://azure.microsoft.com/free/dotnet/)
+- An [Azure subscription](https://azure.microsoft.com/free/dotnet/).
 - A [TokenCredential](/dotnet/api/azure.core.tokencredential?view=azure-dotnet&preserve-view=false) implementation, such as an [Azure Identity library credential type](/dotnet/api/overview/azure/Identity-readme#credential-classes).
 
 ### Install the package

docs/core/compatibility/aspnet-core/6.0/obsolete-removed-apis.md

@@ -38,7 +38,7 @@ Use the recommended replacement APIs.
 * Removed the constructor [Microsoft.AspNetCore.Mvc.Infrastructure.ObjectResultExecutor](/dotnet/api/microsoft.aspnetcore.mvc.infrastructure.objectresultexecutor.-ctor?view=aspnetcore-3.1&preserve-view=true#Microsoft_AspNetCore_Mvc_Infrastructure_ObjectResultExecutor__ctor_Microsoft_AspNetCore_Mvc_Infrastructure_OutputFormatterSelector_Microsoft_AspNetCore_Mvc_Infrastructure_IHttpResponseStreamWriterFactory_Microsoft_Extensions_Logging_ILoggerFactory_). Use <xref:Microsoft.AspNetCore.Mvc.Infrastructure.ObjectResultExecutor.%23ctor(Microsoft.AspNetCore.Mvc.Infrastructure.OutputFormatterSelector,Microsoft.AspNetCore.Mvc.Infrastructure.IHttpResponseStreamWriterFactory,Microsoft.Extensions.Logging.ILoggerFactory,Microsoft.Extensions.Options.IOptions{Microsoft.AspNetCore.Mvc.MvcOptions})?displayProperty=nameWithType> instead.
 * Removed [Microsoft.AspNetCore.Mvc.ModelBinding.Validation.ValidationVisitor.AllowShortCircuitingValidationWhenNoValidatorsArePresent](/dotnet/api/microsoft.aspnetcore.mvc.modelbinding.validation.validationvisitor.allowshortcircuitingvalidationwhennovalidatorsarepresent?view=aspnetcore-3.1&preserve-view=true#Microsoft_AspNetCore_Mvc_ModelBinding_Validation_ValidationVisitor_AllowShortCircuitingValidationWhenNoValidatorsArePresent).
 * Removed [Microsoft.AspNetCore.Mvc.ViewFeatures.ViewComponentResultExecutor](/dotnet/api/microsoft.aspnetcore.mvc.viewfeatures.viewcomponentresultexecutor.-ctor?view=aspnetcore-3.1&preserve-view=true#Microsoft_AspNetCore_Mvc_ViewFeatures_ViewComponentResultExecutor__ctor_Microsoft_Extensions_Options_IOptions_Microsoft_AspNetCore_Mvc_MvcViewOptions__Microsoft_Extensions_Logging_ILoggerFactory_System_Text_Encodings_Web_HtmlEncoder_Microsoft_AspNetCore_Mvc_ModelBinding_IModelMetadataProvider_Microsoft_AspNetCore_Mvc_ViewFeatures_ITempDataDictionaryFactory_). Use <xref:Microsoft.AspNetCore.Mvc.ViewFeatures.ViewComponentResultExecutor.%23ctor(Microsoft.Extensions.Options.IOptions{Microsoft.AspNetCore.Mvc.MvcViewOptions},Microsoft.Extensions.Logging.ILoggerFactory,System.Text.Encodings.Web.HtmlEncoder,Microsoft.AspNetCore.Mvc.ModelBinding.IModelMetadataProvider,Microsoft.AspNetCore.Mvc.ViewFeatures.ITempDataDictionaryFactory,Microsoft.AspNetCore.Mvc.Infrastructure.IHttpResponseStreamWriterFactory)?displayProperty=nameWithType> instead.
-* Obsoleted [CompatibilityVersion](/dotnet/api/microsoft.aspnetcore.mvc.compatibilityversion?view=aspnetcore-3.1&preserve-view=true)
+* Obsoleted [CompatibilityVersion](/dotnet/api/microsoft.aspnetcore.mvc.compatibilityversion?view=aspnetcore-3.1&preserve-view=true).
 
 <!--