API:Web.HTTPApp.TWebModule.BeforeDispatch
Delphi
property BeforeDispatch: THTTPMethodEvent read FBeforeDispatch write FBeforeDispatch;
C++
__property BeforeDispatch;
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| event | published | Web.HTTPApp.pas Web.HTTPApp.hpp |
Web.HTTPApp | TWebModule |
説明
ディスパッチャが HTTP リクエストメッセージとアクション項目との照合を試行する前に発生します。 {{#multireplace:Web.HTTPApp.TWebModule.BeforeDispatch|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} は {{#multireplace:Web.HTTPApp.TCustomWebDispatcher.BeforeDispatch|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を継承しています。以下の内容はすべて {{#multireplace:Web.HTTPApp.TCustomWebDispatcher.BeforeDispatch|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を参照しています。
ディスパッチャが HTTP リクエストメッセージとアクション項目との照合を試行する前に発生します。
BeforeDispatch イベントハンドラを記述すると，すべての HTTP リクエストメッセージの前処理を行うことができます。BeforeDispatch イベントハンドラは，レスポンスに適したアクション項目を使用可能または使用不可にしたり，レスポンスオブジェクトの作成を開始したり，その他の必要な前処理を行うことができます。
BeforeDispatch イベントハンドラでレスポンスオブジェクトの作成を完了したら，ディスパッチャがどのアクション項目にもリクエストを送信しないように，Handled パラメータを true に変更する必要があります。BeforeDispatch イベントハンドラがレスポンスメッセージを送信する場合，Handled パラメータが False のままでも，ディスパッチャはアクション項目にリクエストを渡しません。
BeforeDispatch イベントハンドラで Handled パラメータを true に設定しているにもかかわらずレスポンスが返されない場合，Web ディスパッチャは AfterDispatch イベントを生成します。