ClaimsPrincipalPermission.CheckAccess(String, String) Methode

Definition

Namespace:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Überprüft, ob der aktuelle Prinzipal berechtigt ist, um die angegebene Aktion für die angegebene Ressource auszuführen.

public:
 static void CheckAccess(System::String ^ resource, System::String ^ action);

public static void CheckAccess (string resource, string action);

static member CheckAccess : string * string -> unit

Public Shared Sub CheckAccess (resource As String, action As String)

Parameter

resource

String

Die Ressource, auf der der Prinzipal autorisiert werden soll.

action

String

Die Aktion, für die der Prinzipal autorisiert werden soll.

Ausnahmen

InvalidOperationException

Der aktuelle Prinzipal ist nicht von ClaimsPrincipal zuweisbar.

- oder -

Es ist kein ClaimsAuthorizationManager konfiguriert.

SecurityException

Die Autorisierungsprüfung ist fehlgeschlagen.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Eine Ressource mithilfe der CheckAccess -Methode geschützt wird. Der konfigurierte Anspruchsautorisierungs-Manager wird aufgerufen, um den aktuellen Prinzipal anhand der angegebenen Ressource und Aktion auszuwerten. Wenn der aktuelle Prinzipal für die angegebene Aktion für die angegebene Ressource nicht autorisiert ist, wird ein SecurityException ausgelöst. Andernfalls wird die Ausführung fortgesetzt.

//
// Method 1. Simple access check using static method. 
// Expect this to be most common method.
//
ClaimsPrincipalPermission.CheckAccess("resource", "action");

Hinweise

Der Prinzipal muss für die angegebene Aktion für die angegebene Ressource autorisiert sein, andernfalls wird die SecurityException Ausnahme ausgelöst.

Die ClaimsAuthorizationManager.CheckAccess Methode des konfigurierten Anspruchsautorisierungs-Managers wird mit einem AuthorizationContext aufgerufen, das aus dem aktiven Prinzipal (CurrentPrincipal), der Ressource und der Aktion besteht.