Share via

IHttpRequestBodyDetectionFeature.CanHaveBody Property

  • Reference

Definition

Namespace:
Microsoft.AspNetCore.Http.Features
Assembly:
Microsoft.AspNetCore.Http.Features.dll
Package:
Microsoft.AspNetCore.Http.Features v5.0.9
Package:
Microsoft.AspNetCore.App.Ref v6.0.6
Package:
Microsoft.AspNetCore.App.Ref v7.0.5
Package:
Microsoft.AspNetCore.App.Ref v8.0.0
Package:
Microsoft.AspNetCore.App.Ref v9.0.0
Source:
IHttpRequestBodyDetectionFeature.cs

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.

Applies to