From 98ce12714ae68b62dd201cfe081c3c4345e44eea Mon Sep 17 00:00:00 2001 From: Andrew Stanton-Nurse Date: Wed, 18 Mar 2020 13:58:46 -0700 Subject: [PATCH] Update XML docs for OnStarting (#19534) --- src/Http/Http.Abstractions/src/HttpResponse.cs | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/src/Http/Http.Abstractions/src/HttpResponse.cs b/src/Http/Http.Abstractions/src/HttpResponse.cs index 7319045b51..231496c1c1 100644 --- a/src/Http/Http.Abstractions/src/HttpResponse.cs +++ b/src/Http/Http.Abstractions/src/HttpResponse.cs @@ -72,14 +72,26 @@ namespace Microsoft.AspNetCore.Http /// /// Adds a delegate to be invoked just before response headers will be sent to the client. + /// Callbacks registered here run in reverse order. /// + /// + /// Callbacks registered here run in reverse order. The last one registered is invoked first. + /// The reverse order is done to replicate the way middleware works, with the inner-most middleware looking at the + /// response first. + /// /// The delegate to execute. /// A state object to capture and pass back to the delegate. public abstract void OnStarting(Func callback, object state); /// /// Adds a delegate to be invoked just before response headers will be sent to the client. + /// Callbacks registered here run in reverse order. /// + /// + /// Callbacks registered here run in reverse order. The last one registered is invoked first. + /// The reverse order is done to replicate the way middleware works, with the inner-most middleware looking at the + /// response first. + /// /// The delegate to execute. public virtual void OnStarting(Func callback) => OnStarting(_callbackDelegate, callback);