TCustomPageDispatcher.OnBeforeRedirectToPage Event

Occurs before the page dispatcher dispatches an HTTP request message in response to an internal redirection request.

Pascal

property OnBeforeRedirectToPage: TDispatchPageParamsHandledEvent;

C++

__property TDispatchPageParamsHandledEvent OnBeforeRedirectToPage;

Description

Write an OnBeforeRedirectToPage event handler to take specific action before an HTTP request is redirected to a Web page module. This event only occurs if an adapter in the WebSnap application executes an adapter action whose options include a redirection (roRedirectHTTPGet or roRedirectHTTPPost).

If the event handler sets Handled to true, the dispatcher assumes it has handled the request and performs no further processing. Otherwise, after the event handler exits, the page dispatcher calls on the Web Module to set up the response message and call SendRedirect.

Tip: To access the Web request and response objects from within an OnBeforeRedirectToPage event handler, call the global WebContext function to access the Web context and read its Request and Response properties.