RoleGroupCollection.GetMatchingRoleGroup(IPrincipal) 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

返回包含指定用户帐户的第一个角色组。

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

一个 IPrincipal，表示用于查找角色组集合的用户帐户。

一个 RoleGroup，表示集合中包含指定用户帐户的第一个角色组。如果该用户不属于集合中的角色组，则返回 null。

user 为 null。

方法 GetMatchingRoleGroup 搜索角色组集合并返回包含指定用户帐户的第一个角色组。方法按角色组添加到集合的顺序搜索集合，并仅返回第一个匹配的角色组。

如果指定的用户帐户不是集合中任何角色组的一部分， null 则返回。

必须配置角色管理才能使用 GetMatchingRoleGroup 方法。有关详细信息，请参阅了解角色管理。