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 必要があります。詳細については、「ロール管理について」を参照してください。