WebSecurity - RequireRoles()


WebSecurity 对象WebSecurity-Objekt

Definition

Wenn der aktuelle Benutzer nicht Mitglied aller angegebenen Rollen ist, setzt die MethodeRequireRoles()den HTTP-Status auf 401 (Unauthorized).


C# und VB-Syntax

WebSecurity.RequireRoles(roles)


Beispiel

Beispiel C#

WebSecurity.RequireRoles("Admin", "Poweruser");

Beispiel VB

WebSecurity.RequireRoles("Admin", "Poweruser")


Parameters

Parameter Type Beschreibung
roles String Eine durch Kommas getrennte Liste von Rollen, denen der aktuelle Benutzer angehören muss.


Rückgabewert

Keine.


Fehler und Ausnahmen

In den folgenden Fällen löst jeder Zugriff auf dasWebSecurity-Objekt eineInvalidOperationException aus:

  • Die MethodeInitializeDatabaseConnection()
  • SimpleMembershipNicht initialisiert (oder in der Website-Konfiguration deaktiviert)

Hinweise

RequireRoles()Überprüft, ob der aktuelle Benutzer Mitgliedallerangegebenen Rollen ist. Wenn der aktuelle Benutzer nichtalleMitglieder der angegebenen Rollen ist, wird der HTTP-Status auf 401 (Unauthorized) gesetzt.

Um zu überprüfen, ob der aktuelle Benutzer authentifiziert wurde, verwenden Sie die RequireAuthenticatedUser()Methode.

Um zu überprüfen, ob der aktuelle Benutzer der angegebene Benutzer ist, verwenden Sie die MethodeRequireUser().


Technische Daten

Name Wert
Namespace WebMatrix.WebData
Assembly WebMatrix.WebData.dll


WebSecurity 对象WebSecurity-Objekt Weitere Erweiterungen