Поделиться через


RoleGroupCollection.GetMatchingRoleGroup(IPrincipal) Метод

Определение

Возвращает первую группу ролей, содержащую указанную учетную запись пользователя.

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

Параметры

user
IPrincipal

Объект IPrincipal, представляющий учетную запись пользователя, которую необходимо найти в коллекции групп ролей.

Возвращаемое значение

Объект RoleGroup, представляющий первую группу ролей в коллекции, которая содержит указанную учетную запись пользователя. Если пользователь не является участником какой-либо группы ролей в коллекции, возвращается значение null.

Исключения

user имеет значение null.

Комментарии

Метод GetMatchingRoleGroup выполняет поиск в коллекции групп ролей и возвращает первую группу ролей, содержащую указанную учетную запись пользователя. Метод выполняет поиск коллекции в порядке добавления групп ролей в коллекцию и возвращает только первую соответствующую группу ролей.

Если указанная учетная запись пользователя не входит ни в одну из групп ролей в коллекции, null возвращается .

Для использования метода необходимо настроить управление ролями GetMatchingRoleGroup . Дополнительные сведения см. в разделе Основные сведения об управлении ролями.

Применяется к

См. также раздел