RoleGroupCollection.GetMatchingRoleGroup(IPrincipal) メソッド

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

指定したユーザー アカウントが格納されている最初のロール グループを返します。

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

コレクション内の指定したユーザー アカウントが格納されている最初のロール グループを表す RoleGroup。 ユーザーがコレクション内のロール グループに含まれていない場合は、null が返されます。

例外

ArgumentNullException

user は null です。

注釈

メソッドは GetMatchingRoleGroup 役割グループ コレクションを検索し、指定したユーザー アカウントを含む最初の役割グループを返します。 メソッドは、役割グループがコレクションに追加された順序でコレクションを検索し、最初に一致する役割グループのみを返します。

指定したユーザー アカウントがコレクション内のどのロール グループにも含まれていない場合は、 null が返されます。

メソッドを使用するには、ロール管理を構成する GetMatchingRoleGroup 必要があります。 詳細については、「 ロール管理について」を参照してください。

適用対象

こちらもご覧ください