Share via


RoleGroupCollection.GetMatchingRoleGroup(IPrincipal) Método

Definição

Retorna o primeiro grupo de funções que contém a conta de usuário especificada.

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

Parâmetros

user
IPrincipal

Um IPrincipal que representa a conta de usuário para localizar a coleção de grupos de funções.

Retornos

RoleGroup

Um RoleGroup que representa o primeiro grupo de funções na coleção que contém a conta de usuário especificada. Se o usuário não é parte de um grupo de funções na coleção, ele retorna null.

Exceções

user é null.

Comentários

O GetMatchingRoleGroup método pesquisa a coleção de grupos de funções e retorna o primeiro grupo de funções que contém a conta de usuário especificada. O método pesquisa a coleção na ordem em que os grupos de funções são adicionados à coleção e retorna apenas o primeiro grupo de funções correspondente.

Se a conta de usuário especificada não fizer parte de nenhum dos grupos de funções na coleção, null será retornada.

Você deve configurar o gerenciamento de funções para usar o GetMatchingRoleGroup método. Para obter mais informações, consulte Noções básicas sobre o Gerenciamento de Funções.

Aplica-se a

Confira também