HttpResponseBase.PushPromise Method

Definition

Promotes a promised object.

Overloads

PushPromise(String)

Supports applications sending push promises to HTTP 2.0 clients. For more information, see HTTP/2 Specification Section 8.2: Server Push.

PushPromise(String, String, NameValueCollection)

Supports applications sending push promises to HTTP 2.0 clients. For more information, see HTTP/2 Specification Section 8.2: Server Push.

PushPromise(String)

Supports applications sending push promises to HTTP 2.0 clients. For more information, see HTTP/2 Specification Section 8.2: Server Push.

public:
 virtual void PushPromise(System::String ^ path);
public virtual void PushPromise (string path);
abstract member PushPromise : string -> unit
override this.PushPromise : string -> unit
Public Overridable Sub PushPromise (path As String)

Parameters

path
String

The URL of the push request. It should be the virtual path of the relative resource that the server wants to push to the client.

Remarks

PushPromise is non-deterministic and applications shouldn't have logic that depends on it. Its only purpose is performance advantage in some cases. There are many conditions (protocol and implementation) that may cause the push requests to be ignored. The expectation is based on fire-and-forget.

Applies to

PushPromise(String, String, NameValueCollection)

Supports applications sending push promises to HTTP 2.0 clients. For more information, see HTTP/2 Specification Section 8.2: Server Push.

public:
 virtual void PushPromise(System::String ^ path, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ headers);
public virtual void PushPromise (string path, string method, System.Collections.Specialized.NameValueCollection headers);
abstract member PushPromise : string * string * System.Collections.Specialized.NameValueCollection -> unit
override this.PushPromise : string * string * System.Collections.Specialized.NameValueCollection -> unit
Public Overridable Sub PushPromise (path As String, method As String, headers As NameValueCollection)

Parameters

path
String

The URL of the push request. It should be the virtual path of the relative resource that the server wants to push to the client.

method
String

Http request method that would be used by the push request.

headers
NameValueCollection

Http request header that would be used by the push request.

Remarks

PushPromise is non-deterministic, and applications shouldn't have logic that depends on it. Its only purpose is performance advantage in some cases. There are many conditions (protocol and implementation) that may cause push requests to be ignored. The expectation is based on fire-and-forget.

Applies to