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 認証とWindowsTokenRoleProviderクラスの両方を使用して、Windows ユーザーのロール情報を取得することを指定します。この要素は 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 理解する