RoleGroupCollection.GetMatchingRoleGroup(IPrincipal) Methode

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Gibt die erste Rollengruppe zurück, die das angegebene Benutzerkonto enthält.

public:
 System::Web::UI::WebControls::RoleGroup ^ GetMatchingRoleGroup(System::Security::Principal::IPrincipal ^ user);
public System.Web.UI.WebControls.RoleGroup GetMatchingRoleGroup (System.Security.Principal.IPrincipal user);
member this.GetMatchingRoleGroup : System.Security.Principal.IPrincipal -> System.Web.UI.WebControls.RoleGroup
Public Function GetMatchingRoleGroup (user As IPrincipal) As RoleGroup

Parameter

user
IPrincipal

Ein IPrincipal, der das Benutzerkonto zum Suchen der Rollengruppenauflistung darstellt.

Gibt zurück

RoleGroup

Eine RoleGroup, die die erste Rollengruppe in der Auflistung darstellt, in der das angegebene Benutzerkonto enthalten ist. Wenn der Benutzer nicht Teil einer Rollengruppe in der Auflistung ist, wird null zurückgegeben.

Ausnahmen

ArgumentNullException

user ist null.

Hinweise

Die GetMatchingRoleGroup Methode durchsucht die Rollengruppensammlung und gibt die erste Rollengruppe zurück, die das angegebene Benutzerkonto enthält. Die -Methode durchsucht die Auflistung in der Reihenfolge, in der Rollengruppen zur Auflistung hinzugefügt werden, und gibt nur die erste übereinstimmende Rollengruppe zurück.

Wenn das angegebene Benutzerkonto nicht Teil einer der Rollengruppen in der Auflistung ist, null wird zurückgegeben.

Sie müssen die Rollenverwaltung für die Verwendung der GetMatchingRoleGroup -Methode konfigurieren. Weitere Informationen finden Sie unter Grundlegendes zur Rollenverwaltung.

Gilt für:

Weitere Informationen