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.RoleGroupPublic Function GetMatchingRoleGroup (user As IPrincipal) As RoleGroupПараметры
- user
- IPrincipal
Объект IPrincipal, представляющий учетную запись пользователя, которую необходимо найти в коллекции групп ролей.
Возвращаемое значение
Объект RoleGroup, представляющий первую группу ролей в коллекции, которая содержит указанную учетную запись пользователя. Если пользователь не является участником какой-либо группы ролей в коллекции, возвращается значение null.
Исключения
user имеет значение null.
Комментарии
Метод GetMatchingRoleGroup выполняет поиск в коллекции групп ролей и возвращает первую группу ролей, содержащую указанную учетную запись пользователя. Метод выполняет поиск коллекции в порядке добавления групп ролей в коллекцию и возвращает только первую соответствующую группу ролей.
Если указанная учетная запись пользователя не входит ни в одну из групп ролей в коллекции, null возвращается .
Для использования метода необходимо настроить управление ролями GetMatchingRoleGroup . Дополнительные сведения см. в разделе Основные сведения об управлении ролями.
