WindowsTokenRoleProvider クラス

リファレンス

定義

名前空間:: System.Web.Security

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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 理解する

次の方法で共有