IHttpRequestBodyDetectionFeature.CanHaveBody Property

Definition

Namespace:

Microsoft.AspNetCore.Http.Features

Assembly:

Microsoft.AspNetCore.Http.Features.dll

Package:

Microsoft.AspNetCore.App.Ref v8.0.0

Indicates if the request can have a body.

public:
 property bool CanHaveBody { bool get(); };

public bool CanHaveBody { get; }

member this.CanHaveBody : bool

Public ReadOnly Property CanHaveBody As Boolean

Property Value

Boolean

Remarks

This returns true when:

• It's an HTTP/1.x request with a non-zero Content-Length or a 'Transfer-Encoding: chunked' header.
• It's an HTTP/2 request that did not set the END_STREAM flag on the initial headers frame.

The final request body length may still be zero for the chunked or HTTP/2 scenarios.

This returns false when:

• It's an HTTP/1.x request with no Content-Length or 'Transfer-Encoding: chunked' header, or the Content-Length is 0.
• It's an HTTP/1.x request with Connection: Upgrade (e.g. WebSockets). There is no HTTP request body for these requests and no data should be received until after the upgrade.
• It's an HTTP/2 request that set END_STREAM on the initial headers frame.

When false, the request body should never return data.