PageRouteHandler.CheckPhysicalUrlAccess Eigenschaft

Definition

Namespace:

System.Web.Routing

Assembly:

System.Web.dll

Ruft einen Wert ab, der bestimmt, ob Autorisierungsregeln auf die URL der physischen Datei angewendet werden.

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

public bool CheckPhysicalUrlAccess { get; }

member this.CheckPhysicalUrlAccess : bool

Public ReadOnly Property CheckPhysicalUrlAccess As Boolean

Eigenschaftswert

Boolean

true, wenn die Autorisierung für die URL der physischen Datei ausgeführt wird, die der Route zugeordnet ist, andernfalls false. Der Standardwert ist true.

Hinweise

Sie können die CheckPhysicalUrlAccess Eigenschaft festlegen, wenn Sie den PageRouteHandler(String, Boolean) Konstruktor verwenden.

Der Wert der CheckPhysicalUrlAccess -Eigenschaft bestimmt, ob das PageRouteHandler Objekt Sicherheitsberechtigungen nur für die Routen-URL oder sowohl für die physische Seite als auch für die Routen-URL überprüft.

Wenn die CheckPhysicalUrlAccess Eigenschaft auf true festgelegt ist (der Standardwert), muss ein Benutzer über die Berechtigung verfügen, sowohl auf die Routen-URL als auch auf die physische URL zuzugreifen. Wenn die CheckPhysicalUrlAccess Eigenschaft auf falsefestgelegt ist, benötigt ein Benutzer nur die Berechtigung für den Zugriff auf die Routen-URL, und die Berechtigungen für die physische URL werden nicht überprüft.

Berechtigungen werden in der Web.config-Datei definiert, wie im folgenden Beispiel gezeigt:

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

Für eine Anforderungs-URL, die nach dem Domänennamen enthält Category/food/show , wendet Category/{action}/{categoryName} ASP.NET die im vorherigen Beispiel definierten Berechtigungen auf eine der folgenden Arten an, wenn das Routing-URL-Muster und die physische Seite Categoriespage.aspx ist:

• Wenn die CheckPhysicalUrlAccess -Eigenschaft lautet false, wird allen Benutzern Zugriff gewährt, da allen Benutzern Zugriff auf das URL-Muster gewährt wird, das mit categorybeginnt.

• Wenn die CheckPhysicalUrlAccess Eigenschaft ist, wird truenur admin Benutzern Der Zugriff gewährt. Alle Benutzer haben Zugriff auf das URL-Muster, das mit categorybeginnt, aber nur admin Benutzer haben Zugriff auf die physische Seite Categoriespage.aspx.

Weitere Informationen

• Route
• ASP.NET-Routing
• Vorgehensweise: Definieren von Routen für Web Forms-Anwendungen
• Exemplarische Vorgehensweise: Verwenden von ASP.NET Routing in einer Web Forms-Anwendung