Web.HTTPApp.TWebActionItem.Default

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property Default: Boolean read FDefault write SetDefault default False;

C++

__property bool Default = {read=FDefault, write=SetDefault, default=0};

Propriétés

Type Visibilité  Source Unité  Parent
property published
Web.HTTPApp.pas
Web.HTTPApp.hpp
Web.HTTPApp TWebActionItem

Description

Indique si l'élément action doit traiter toute requête n'ayant pas été gérée par aucun autre élément action disponible.

Affectez la valeur true à la propriété Default pour faire de cet élément action, l'élément par défaut de la liste des éléments action gérée par l'objet TWebDispatcher. TWebDispatcher tente de faire correspondre les messages de requête HTTP aux éléments action en faisant correspondre les propriétés MethodType et PathInfo de l'URI cible. Si aucune correspondance n'est trouvée, TWebDispatcher appelle l'élément action par défaut sans tenir compte de ses propriétés MethodType ou PathInfo.

Quand un élément action est choisi comme l'élément action par défaut, la valeur de sa propriété Enabled n'est pas prise en compte. Donc, si un élément action a sa propriété Enabled à false et Default à true, TWebDispatcher commence par rechercher une correspondance avec les autres éléments action quand bien même les propriétés PathInfo et MethodType de l'élément action par défaut correspondent parfaitement à la requête. Et, c'est seulement une fois que tous les autres éléments action ont été rejetés que TWebDispatcher sélectionne l'élément action par défaut. Si l'élément action par défaut est activé, il peut être sélectionné avant que les autres éléments action ne soient envisagés si ses propriétés MethodType et PathInfo correspondent à la requête.

L'élément action par défaut doit être préparé à générer une réponse pour toute requête HTTP quelles que soient les valeurs de MethodType et PathInfo. Cela peut simplement consister à définir le code de statut de la réponse à 404 (il n'y a pas de correspondant pour l'URI) ou 405 (la méthode de requête n'est pas gérée).

L'affectation de la valeur true à Default, affecte la valeur false à la propriété Default du précédent élément action par défaut.

Voir aussi