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);