HttpMethodOverrideExtensions.UseHttpMethodOverride Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
| Name | Description |
|---|---|
| UseHttpMethodOverride(IApplicationBuilder) |
Allows incoming POST request to override method type with type specified in header. This middleware is used when a client is limited to sending GET or POST methods but wants to invoke other HTTP methods. By default, the X-HTTP-Method-Override request header is used to specify the HTTP method being tunneled. |
| UseHttpMethodOverride(IApplicationBuilder, HttpMethodOverrideOptions) |
Allows incoming POST request to override method type with type specified in form. This middleware is used when a client is limited to sending GET or POST methods but wants to invoke other HTTP methods. |
UseHttpMethodOverride(IApplicationBuilder)
Allows incoming POST request to override method type with type specified in header. This middleware is used when a client is limited to sending GET or POST methods but wants to invoke other HTTP methods. By default, the X-HTTP-Method-Override request header is used to specify the HTTP method being tunneled.
public:
[System::Runtime::CompilerServices::Extension]
static Microsoft::AspNetCore::Builder::IApplicationBuilder ^ UseHttpMethodOverride(Microsoft::AspNetCore::Builder::IApplicationBuilder ^ builder);
public static Microsoft.AspNetCore.Builder.IApplicationBuilder UseHttpMethodOverride(this Microsoft.AspNetCore.Builder.IApplicationBuilder builder);
static member UseHttpMethodOverride : Microsoft.AspNetCore.Builder.IApplicationBuilder -> Microsoft.AspNetCore.Builder.IApplicationBuilder
<Extension()>
Public Function UseHttpMethodOverride (builder As IApplicationBuilder) As IApplicationBuilder
Parameters
- builder
- IApplicationBuilder
The IApplicationBuilder instance this method extends.
Returns
Applies to
UseHttpMethodOverride(IApplicationBuilder, HttpMethodOverrideOptions)
Allows incoming POST request to override method type with type specified in form. This middleware is used when a client is limited to sending GET or POST methods but wants to invoke other HTTP methods.
public:
[System::Runtime::CompilerServices::Extension]
static Microsoft::AspNetCore::Builder::IApplicationBuilder ^ UseHttpMethodOverride(Microsoft::AspNetCore::Builder::IApplicationBuilder ^ builder, Microsoft::AspNetCore::Builder::HttpMethodOverrideOptions ^ options);
public static Microsoft.AspNetCore.Builder.IApplicationBuilder UseHttpMethodOverride(this Microsoft.AspNetCore.Builder.IApplicationBuilder builder, Microsoft.AspNetCore.Builder.HttpMethodOverrideOptions options);
static member UseHttpMethodOverride : Microsoft.AspNetCore.Builder.IApplicationBuilder * Microsoft.AspNetCore.Builder.HttpMethodOverrideOptions -> Microsoft.AspNetCore.Builder.IApplicationBuilder
<Extension()>
Public Function UseHttpMethodOverride (builder As IApplicationBuilder, options As HttpMethodOverrideOptions) As IApplicationBuilder
Parameters
- builder
- IApplicationBuilder
The IApplicationBuilder instance this method extends.
- options
- HttpMethodOverrideOptions
The HttpMethodOverrideOptions which indicates which form type specifies the override method.
Returns
Remarks
When FormFieldName is set and the request has a form content type, this middleware reads the incoming POST form before later middleware runs. The request method is overridden only if the configured form field is present and has a non-empty value.
ASP.NET Core antiforgery middleware validates tokens only for HTTP POST, PUT, and PATCH requests. If you need validation for an overridden method outside that set (for example, DELETE), resolve IAntiforgery from DI and call ValidateRequestAsync or IsRequestValidAsync in the endpoint handler.