Skip to content

[Discussion] Announcement: Minimal API renames in RC1 and RC2 #37671

@halter73

Description

@halter73

Discussion for the following announcements:

  1. [Breaking change]: Minimal API renames in RC1 aspnet/Announcements#474
  2. [Breaking change]: Minimal API renames in RC2 aspnet/Announcements#475

Versions

  1. .NET 6 RC1
  2. .NET 6 RC2

Description

In RC1, the following APIs were renamed.

  • The Microsoft.AspNetCore.Builder.MinimalActionEndpointConventionBuilder class was renamed to Microsoft.AspNetCore.Builder.DelegateEndpointConventionBuilder.
  • The Microsoft.AspNetCore.Builder.MinimalActionEndpointRouteBuilderExtensions class was renamed to Microsoft.AspNetCore.Builder.DelegateEndpointRouteBuilderExtensions.
  • The Delegate parameter to Map, MapGet, MapPost, MapPut, MapDelete, MapMethod, MapFallback and RequestDelegateFactory.Create was renamed from action to handler.

These changes were made in #35570.

In RC2, the following APIs were renamed or merged.

  • The Microsoft.AspNetCore.Builder.DelegateEndpointConventionBuilder class was renamed to Microsoft.AspNetCore.Builder.RouteHandlerBuilder.
  • The Microsoft.AspNetCore.Http.OpenApiDelegateEndpointConventionBuilderExtensions class was renamed to Microsoft.AspNetCore.Http.OpenApiRouteHandlerBuilderExtensions.
  • The Microsoft.AspNetCore.Builder.DelegateEndpointRouteBuilderExtensions class was removed and all of its methods were merged into the existing Microsoft.AspNetCore.Builder.EndpointRouteBuilderExtensions class.

These changes were made in #36578.

Type of breaking change

  • Binary incompatible: Existing binaries may encounter a breaking change in behavior, such as failure to load/execute or different run-time behavior.
  • Source incompatible: Source code may encounter a breaking change in behavior when targeting the new runtime/component/SDK, such as compile errors or different run-time behavior.

Recommended action

It is recommended you recompile any projects built with an earlier SDK. For most projects, this should be all that is necessary.

If any of these type names or parameter names were referenced directly by name, the source should be updated to reflect the new names.

Metadata

Metadata

Assignees

No one assigned

    Labels

    old-area-web-frameworks-do-not-use*DEPRECATED* This label is deprecated in favor of the area-mvc and area-minimal labels

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions