PageRouteHandler.CheckPhysicalUrlAccess Propriété

Définition

Espace de noms:

System.Web.Routing

Assembly:

System.Web.dll

Obtient une valeur qui détermine si des règles d'autorisation sont appliquées à l'URL du fichier physique.

public:
 property bool CheckPhysicalUrlAccess { bool get(); };

public bool CheckPhysicalUrlAccess { get; }

member this.CheckPhysicalUrlAccess : bool

Public ReadOnly Property CheckPhysicalUrlAccess As Boolean

Valeur de propriété

Boolean

true si l'autorisation est vérifiée pour l'URL du fichier physique associé à l'itinéraire ; sinon, false. La valeur par défaut est true.

Remarques

Vous pouvez définir la CheckPhysicalUrlAccess propriété lorsque vous utilisez le PageRouteHandler(String, Boolean) constructeur.

La valeur de la CheckPhysicalUrlAccess propriété détermine si l’objet PageRouteHandler vérifie les autorisations de sécurité uniquement pour l’URL de l’itinéraire ou pour la page physique et l’URL de l’itinéraire.

Lorsque la CheckPhysicalUrlAccess propriété est définie sur true (qui est sa valeur par défaut), un utilisateur doit avoir l’autorisation d’accéder à la fois à l’URL d’itinéraire et à l’URL physique. Lorsque la propriété a la CheckPhysicalUrlAccessfalsevaleur , un utilisateur a uniquement besoin d’une autorisation pour accéder à l’URL de l’itinéraire, et les autorisations pour l’URL physique ne sont pas vérifiées.

Les autorisations sont définies dans le fichier Web.config, comme illustré dans l’exemple suivant :

<configuration>
  <location path="categoriespage.aspx">
    <system.web>
      <authorization>
        <allow roles="admin"/>
        <deny users="*"/>
      </authorization>
    </system.web>
  </location>
  <location path="category">
    <system.web>
      <authorization>
        <allow users="*"/>
      </authorization>
    </system.web>
  </location>
</configuration>

Pour une URL de requête qui contient Category/food/show après le nom de domaine, si le modèle d’URL d’itinéraire est Category/{action}/{categoryName} et que la page physique est Categoriespage.aspx, ASP.NET applique les autorisations définies dans l’exemple précédent de l’une des manières suivantes :

• Si la propriété a la CheckPhysicalUrlAccess valeur , l’accès est falseaccordé à tous les utilisateurs, car tous les utilisateurs ont accès au modèle d’URL qui commence par category.

• Si la propriété a la CheckPhysicalUrlAccess valeur true, seuls admin les utilisateurs sont autorisés à accéder. Tous les utilisateurs ont accès au modèle d’URL qui commence categorypar , mais seuls admin les utilisateurs ont accès à la page physique Categoriespage.aspx.

Voir aussi

• Route
• Routage ASP.NET
• Guide pratique pour définir des itinéraires pour les applications Web Forms
• Procédure pas à pas : utilisation du routage ASP.NET dans une application Web Forms