RoleGroupCollection.GetMatchingRoleGroup(IPrincipal) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.RoleGroupPublic Function GetMatchingRoleGroup (user As IPrincipal) As RoleGroupParameter
- user
- IPrincipal
Ein IPrincipal, der das Benutzerkonto zum Suchen der Rollengruppenauflistung darstellt.
Gibt zurück
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
user ist null
Hinweise
Die GetMatchingRoleGroup -Methode durchsucht die Rollengruppenauflistung und gibt die erste Rollengruppe zurück, die das angegebene Benutzerkonto enthält. Die -Methode durchsucht die Auflistung in der Reihenfolge, in der Rollengruppen der 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.
