WindowsTokenRoleProvider クラス

定義

名前空間:

System.Web.Security

アセンブリ:

System.Web.dll

Windows グループ メンバーシップから ASP.NET アプリケーションのロール情報を取得します。

public ref class WindowsTokenRoleProvider : System::Web::Security::RoleProvider

public class WindowsTokenRoleProvider : System.Web.Security.RoleProvider

type WindowsTokenRoleProvider = class
    inherit RoleProvider

Public Class WindowsTokenRoleProvider
Inherits RoleProvider

継承

Object

ProviderBase

RoleProvider

WindowsTokenRoleProvider

例

次の例は、ASP.NET アプリケーションの Web.config ファイルを示しています。 アプリケーションが Windows 認証と クラスの両方を使用して Windows ユーザーの WindowsTokenRoleProvider ロール情報を取得することを指定します。 要素は authorization 、BUILTIN\Administrators グループ内のユーザーのみがアプリケーションへのアクセスを許可するように指定します。

<configuration>
  <system.web>
    <authentication mode="Windows" />

    <authorization>
      <allow roles="BUILTIN\Administrators" />
      <deny users="*" />
    </authorization>

    <roleManager defaultProvider="WindowsProvider"
      enabled="true"
      cacheRolesInCookie="false">
      <providers>
        <add
          name="WindowsProvider"
          type="System.Web.Security.WindowsTokenRoleProvider" />
      </providers>
    </roleManager>

  </system.web>
</configuration>

注釈

クラスは WindowsTokenRoleProvider 、Windows セキュリティ グループに基づいて Windows ユーザーのロール情報を取得する読み取り専用ロール メンバーシップ プロバイダーです。 これは、IIS 認証設定で匿名認証が無効になっている Windows 認証モードを使用する ASP.NET アプリケーションで最も便利です。 特定の Windows グループ ASP.NET ユーザーのメンバーシップに基づいてアクセスを許可または拒否するようにアプリケーションを構成できます。

クラスを WindowsTokenRoleProvider 使用して、ロールを作成または削除したり、Windows グループ メンバーシップに基づくロールのメンバーシップを変更したりすることはできません。 この機能は、Windows オペレーティング システムによって管理されます。 クラスでは WindowsTokenRoleProvider 、抽象クラスの IsUserInRole メソッドと GetRolesForUser メソッドのみがサポートされます RoleProvider 。

コンストラクター

WindowsTokenRoleProvider()

WindowsTokenRoleProvider クラスのインスタンスを作成します。

プロパティ

ApplicationName	アプリケーションの名前を取得または設定します。
Description	管理ツールまたは他のユーザー インターフェイス (UI) での表示に適した、簡単でわかりやすい説明を取得します。 (継承元 ProviderBase)
Name	構成時にプロバイダーを参照するために使用される表示名を取得します。 (継承元 ProviderBase)

メソッド

AddUsersToRoles(String[], String[])	このメソッドは、Windows トークンのロール プロバイダーでサポートされていません。
CreateRole(String)	このメソッドは、Windows トークンのロール プロバイダーでサポートされていません。
DeleteRole(String, Boolean)	このメソッドは、Windows トークンのロール プロバイダーでサポートされていません。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
FindUsersInRole(String, String)	このメソッドは、Windows トークンのロール プロバイダーでサポートされていません。
GetAllRoles()	このメソッドは、Windows トークンのロール プロバイダーでサポートされていません。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetRolesForUser(String)	ユーザーが属する Windows グループの一覧を取得します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetUsersInRole(String)	このメソッドは、Windows トークンのロール プロバイダーでサポートされていません。
Initialize(String, NameValueCollection)	ASP.NET アプリケーションの構成ファイルに指定されているプロパティ値を使用して、Windows トークン ロール プロバイダーを初期化します。 このメソッドはコードから直接使用するためのものではありません。
IsUserInRole(String, String)	指定したユーザーが指定した Windows グループに存在するかどうかを示す値を取得します。
IsUserInRole(String, WindowsBuiltInRole)	指定したユーザーが指定した組み込みの Windows ロールに存在するかどうかを示す値を取得します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
RemoveUsersFromRoles(String[], String[])	このメソッドは、Windows トークンのロール プロバイダーでサポートされていません。
RoleExists(String)	このメソッドは、Windows トークンのロール プロバイダーでサポートされていません。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

こちらもご覧ください

• ロール管理 ASP.NET 理解する