RoleManagerSection クラス

Web アプリケーションのロール管理インフラストラクチャをサポートするために使用される構成設定を定義します。

構文

class RoleManagerSection : ConfigurationSectionWithCollection  

メソッド

次の表に、RoleManagerSection クラスによって公開されるメソッドの一覧を示します。

名前	説明
[追加]	(ConfigurationSectionWithCollection から継承。)
Clear	(ConfigurationSectionWithCollection から継承。)
Get	(ConfigurationSectionWithCollection から継承。)
GetAllowDefinition	(ConfigurationSection から継承。)
GetAllowLocation	(ConfigurationSection から継承。)
削除	(ConfigurationSectionWithCollection から継承。)
RevertToParent	(ConfigurationSection から継承。)
SetAllowDefinition	(ConfigurationSection から継承。)
SetAllowLocation	(ConfigurationSection から継承。)

プロパティ

次の表は、RoleManagerSection クラスによって公開されるプロパティの一覧です。

名前	説明
CacheRolesInCookie	読み取り/書き込みの boolean 値。 現在のユーザーのロールがクッキーにキャッシュされている場合は true、それ以外の場合は false です。 既定値は、false です。
CookieName	ロール名のキャッシュに使用される Cookie の名前を指定する読み取り/書き込み string 値。 既定値は ".ASPXROLES" です。
CookiePath	ロール名のキャッシュに使用される Cookie の仮想パスを指定する読み取り/書き込み string 値。 既定値は "/" です。
CookieProtection	Cookie 保護スキームを指定する読み取り/書き込みの sint32 列挙型。 使用できる値の一覧は、後述の「注釈」セクションに示します。
CookieRequireSSL	読み取り/書き込みの boolean 値。 ロール名のキャッシュに使用される Cookie がサーバーに返されるために Secure Sockets Layer (SSL) 接続が必要な場合は true、それ以外の場合は false です。 既定値は、false です。
CookieSlidingExpiration	読み取り/書き込みの boolean 値。 ロール名のキャッシュに使用される Cookie が定期的にリセットされる場合は true、それ以外の場合は false です。 既定値は、true です。
CookieTimeout	ロール名のキャッシュに使用される Cookie の有効期限が切れるまでの時間を分単位で指定する読み取り/書き込み datetime 値。 デフォルトは 30 分です。
CreatePersistentCookie	読み取り/書き込みの boolean 値。 ロール名がブラウザー セッション間で Cookie に永続的な名前になっている場合は true、それ以外の場合は false です。 既定値は false です。 CreatePersistentCookie プロパティは、ロール名のキャッシュに使用される Cookie が永続的な Cookie である必要があるかどうかを示します。つまり、Cookie はブラウザー セッション間で使用できます。つまり、セッション ベースの Cookie は、ブラウザーが閉じられたときに Cookie が失われることを意味します。 既定値は false であり、セッション ベースの Cookie を使用してロール名をキャッシュすることを示します。
DefaultProvider	ロールの管理に使用される既定のプロバイダーの名前を指定する読み取り/書き込み string 値。 既定値は "AspNetSqlRoleProvider" です。 このプロパティは、Providers プロパティで指定された名前付き値と一致する必要があります。 空の文字列 ("") は有効な値ではありません。
Domain	ロール名のキャッシュに使用される Cookie に関連付けられている doメイン の名前を指定する読み取り/書き込み string 値。 既定値は、空の文字列 ("") です。 値が指定されていない場合、Domain プロパティは nullを返します。
Enabled	読み取り/書き込みの boolean 値。 ASP.NET ロール管理機能が有効になっている場合 (つまり、実行時にアクセスできる場合) は true、それ以外の場合は false です。 既定値は、false です。
Location	(ConfigurationSection から継承。)キー プロパティ。
MaxCachedResults	ロール Cookie にキャッシュするロールの最大数 ASP.NET を指定する読み取り/書き込み sint32 値。 既定値は 25 です。
Path	(ConfigurationSection から継承。)キー プロパティ。
Providers	ロール管理プロバイダを指定する ProvidersSettings 値。 注: ロール管理プロバイダーは、サイトの役割の種類へのアクセスを提供するコンポーネントです。
SectionInformation	(ConfigurationSection から継承。)

サブクラス

このクラスにはサブクラスが含まれていません。

解説

次の表に、CookieProtection プロパティとして使用できる値の一覧を示します。 既定値は 3 (All) です。

Value	キーワード	説明
0	None	Cookie 情報が保護されていないことを指定します。 Cookie の情報はクリア テキストで保存され、情報がサーバーに返送されるときに検証されません。
1	Validation	情報がサーバーに送り返される前に、Cookie 内の情報が変更されていないことを確認します。
2	Encryption	Cookie 内の情報を暗号化します。
3	All	Cookie 内の情報を保護するために、Validation 値と Encryption 値の両方が使用されることを指定します。

継承階層

ConfigurationSection

ConfigurationSectionWithCollection

RoleManagerSection

要件

型	説明
クライアント	- Windows Vista 上の IIS 7.0 - Windows 7 上の IIS 7.5 - Windows 8 上の IIS 8.0 - Windows 10 上の IIS 10.0
[サーバー]	- Windows Server 2008 上の IIS 7.0 - Windows Server 2008 R2 上の IIS 7.5 - Windows Server 2012 上の IIS 8.0 - Windows Server 2012 R2 上の IIS 8.5 - Windows Server 2016 上の IIS 10.0
Product	- IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF ファイル	WebAdministration.mof

参照

ConfigurationSectionWithCollection クラス
NameTypeElement クラス
ProvidersSettings クラス
CIM_DATETIME