WindowsTokenRoleProviderとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

WindowsTokenRoleProvider クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Class WindowsTokenRoleProvider
    Inherits RoleProvider

Visual Basic (使用法)

Dim instance As WindowsTokenRoleProvider

public class WindowsTokenRoleProvider : RoleProvider

C++

public ref class WindowsTokenRoleProvider :
 public RoleProvider

public class WindowsTokenRoleProvider extends
 RoleProvider

JScript

public class WindowsTokenRoleProvider extends
 RoleProvider

解説

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

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

使用例

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>

.NET Framework のセキュリティ

AspNetHostingPermission (ホスト環境で WindowsTokenRoleProvider クラスを使用するために必要なアクセス許可)要求値 : LinkDemand。アクセス許可値 : Minimal。

継承階層

System.Object
   System.Configuration.Provider.ProviderBase
     System.Web.Security.RoleProvider
      System.Web.Security.WindowsTokenRoleProvider

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WindowsTokenRoleProvider メンバ
System.Web.Security 名前空間
その他の技術情報
ロール管理について

WindowsTokenRoleProvider コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New WindowsTokenRoleProvider

public WindowsTokenRoleProvider ()

C++

public:
WindowsTokenRoleProvider ()

public WindowsTokenRoleProvider ()

JScript

public function WindowsTokenRoleProvider ()

解説

WindowsTokenRoleProvider コンストラクタは、アプリケーションの構成に指定された WindowsTokenRoleProvider クラスのインスタンスを作成する際、ASP.NET によって呼び出されます。このコンストラクタは、コードで使用するためのものではありません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WindowsTokenRoleProvider クラス
WindowsTokenRoleProvider メンバ
System.Web.Security 名前空間
その他の技術情報
ロール管理について

WindowsTokenRoleProvider プロパティ

パブリックプロパティパブリックプロパティ

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

参照

その他の技術情報

ロール管理について

WindowsTokenRoleProvider メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	AddUsersToRoles	オーバーライドされます。このメソッドは、Windows トークンロールプロバイダではサポートされていません。
	CreateRole	オーバーライドされます。このメソッドは、Windows トークンロールプロバイダではサポートされていません。
	DeleteRole	オーバーライドされます。このメソッドは、Windows トークンロールプロバイダではサポートされていません。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	FindUsersInRole	オーバーライドされます。このメソッドは、Windows トークンロールプロバイダではサポートされていません。
	GetAllRoles	オーバーライドされます。このメソッドは、Windows トークンロールプロバイダではサポートされていません。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetRolesForUser	オーバーライドされます。ユーザーが属する Windows グループの一覧を取得します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	GetUsersInRole	オーバーライドされます。このメソッドは、Windows トークンロールプロバイダではサポートされていません。
	Initialize	オーバーライドされます。 ASP.NET アプリケーションの構成ファイルに指定されているプロパティ値を使用して、Windows トークンロールプロバイダを初期化します。このメソッドは、コードで直接使用するためのものではありません。
	IsUserInRole	オーバーロードされます。オーバーライドされます。指定したユーザーが指定した組み込みの Windows ロールに存在するかどうかを示す値を取得します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	RemoveUsersFromRoles	オーバーライドされます。このメソッドは、Windows トークンロールプロバイダではサポートされていません。
	RoleExists	オーバーライドされます。このメソッドは、Windows トークンロールプロバイダではサポートされていません。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

その他の技術情報

ロール管理について

WindowsTokenRoleProvider メンバ

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

WindowsTokenRoleProvider データ型で公開されるメンバを以下の表に示します。

パブリックコンストラクタ

	名前	説明
	WindowsTokenRoleProvider	WindowsTokenRoleProvider クラスのインスタンスを作成します。

パブリックプロパティ

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

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	AddUsersToRoles	オーバーライドされます。このメソッドは、Windows トークンロールプロバイダではサポートされていません。
	CreateRole	オーバーライドされます。このメソッドは、Windows トークンロールプロバイダではサポートされていません。
	DeleteRole	オーバーライドされます。このメソッドは、Windows トークンロールプロバイダではサポートされていません。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	FindUsersInRole	オーバーライドされます。このメソッドは、Windows トークンロールプロバイダではサポートされていません。
	GetAllRoles	オーバーライドされます。このメソッドは、Windows トークンロールプロバイダではサポートされていません。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetRolesForUser	オーバーライドされます。ユーザーが属する Windows グループの一覧を取得します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	GetUsersInRole	オーバーライドされます。このメソッドは、Windows トークンロールプロバイダではサポートされていません。
	Initialize	オーバーライドされます。 ASP.NET アプリケーションの構成ファイルに指定されているプロパティ値を使用して、Windows トークンロールプロバイダを初期化します。このメソッドは、コードで直接使用するためのものではありません。
	IsUserInRole	オーバーロードされます。オーバーライドされます。指定したユーザーが指定した組み込みの Windows ロールに存在するかどうかを示す値を取得します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	RemoveUsersFromRoles	オーバーライドされます。このメソッドは、Windows トークンロールプロバイダではサポートされていません。
	RoleExists	オーバーライドされます。このメソッドは、Windows トークンロールプロバイダではサポートされていません。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)