乐胖代购免代理版

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

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

RolePrincipal.IsRoleListCached プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ユーザーのロールの一覧が Cookie にキャッシュされているかどうかを示す値を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 IsRoleListCached As Boolean

Visual Basic (使用法)

Dim instance As RolePrincipal
Dim value As Boolean

value = instance.IsRoleListCached

public bool IsRoleListCached { get;
 }

C++

public:
property bool IsRoleListCached {
    bool get ();
}

/** @property */
public boolean get_IsRoleListCached ()

JScript

public function get IsRoleListCached
 () : boolean

プロパティ値
ロール名が Cookie にキャッシュされている場合は true。それ以外の場合は false。

解説

アプリケーションの Web.config ファイルの cacheRolesInCookie 属性が true に設定されている場合、特定のロールのユーザーメンバシップを確認する際に現在のユーザーのロール名の一覧が Cookie に書き込まれます。IsRoleListCached プロパティは、ロール名が Cookie に書き込まれているかどうかを示します。cacheRolesInCookie 構成属性が true であっても、Cookie にロール情報が書き込まれるまで、IsRoleListCached プロパティは true を返さないことに注意してください。ユーザーに対してロールチェックが実行されない場合、IsRoleListCached は false を返します。

使用例

ロール管理が有効になっている場合に、現在のユーザーのロールのキャッシュ情報を表示する例を次に示します。ロール管理の有効化の詳細については、Roles クラスのトピックを参照してください。

Visual Basic

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security"
 %>

<script runat="server">

Public Sub Page_Load()

    Try
    Dim r As RolePrincipal = CType(User, RolePrincipal)

    IsCachedLabel.Text     = r.IsRoleListCached.ToString()
    CacheChangedLabel.Text = r.CachedListChanged.ToString()
    ExpiredLabel.Text      = r.Expired.ToString()
    VersionLabel.Text      = r.Version.ToString()
    IssueDateLabel.Text    = r.IssueDate.ToString()
    ExpireDateLabel.Text   = r.ExpireDate.ToString()
    CookiePathLabel.Text   = r.CookiePath

    Msg.Text = ""
  Catch e As InvalidCastException
    Msg.Text = "User is not of type RolePrincipal. Are roles enabled?"
  End Try

End Sub

</script>
<html>
<head>
<title>Role Information</title>
</head>
<body>

<form runat="server">

  Role Information for <B><%=User.Identity.Name%></B>.<BR>

  <asp:Label id="Msg" runat="Server"
 ForeColor="maroon" /><BR>

  <table border=1 cellpadding=4 cellspacing=4>
    <tr>
      <td>IsRoleListCached</td>
      <td><asp:Label id="IsCachedLabel" runat="Server"
 /></td>
    </tr>
    <tr>
      <td>CachedListChanged</td>  
      <td><asp:Label id="CacheChangedLabel"
 runat="Server" /></td>
    </tr>
    <tr>
      <td>Expired</td>
      <td><asp:Label id="ExpiredLabel" runat="Server"
 /></td>
    </tr>
    <tr>
      <td>Version</td>
      <td><asp:Label id="VersionLabel" runat="Server"
 /></td>
    </tr>
    <tr>
      <td>IssueDate</td>
      <td><asp:Label id="IssueDateLabel"
 runat="Server" /></td>
    </tr>
    <tr>
      <td>ExpireDate</td>
      <td><asp:Label id="ExpireDateLabel"
 runat="Server" /></td>
    </tr>
    <tr>
      <td>CookiePath</td>
      <td><asp:Label id="CookiePathLabel"
 runat="Server" /></td>
    </tr>
  </table>

</form>


</body>
</html>

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>

<script runat="server">

public void Page_Load()
{

  try
  {
    RolePrincipal r = (RolePrincipal)User;

    IsCachedLabel.Text     = r.IsRoleListCached.ToString();
    CacheChangedLabel.Text = r.CachedListChanged.ToString();
    ExpiredLabel.Text      = r.Expired.ToString();
    VersionLabel.Text      = r.Version.ToString();
    IssueDateLabel.Text    = r.IssueDate.ToString();
    ExpireDateLabel.Text   = r.ExpireDate.ToString();
    CookiePathLabel.Text   = r.CookiePath;

    Msg.Text = "";
  }
  catch (InvalidCastException)
  {
    Msg.Text = "User is not of type RolePrincipal. Are roles enabled?";
  }

}

</script>
<html>
<head>
<title>Role Information</title>
</head>
<body>

<form runat="server">

  Role Information for <B><%=User.Identity.Name%></B>.<BR>

  <asp:Label id="Msg" runat="Server" ForeColor="maroon"
 /><BR>

  <table border=1 cellpadding=4 cellspacing=4>
    <tr>
      <td>IsRoleListCached</td>
      <td><asp:Label id="IsCachedLabel" runat="Server"
 /></td>
    </tr>
    <tr>
      <td>CachedListChanged</td>  
      <td><asp:Label id="CacheChangedLabel" runat="Server"
 /></td>
    </tr>
    <tr>
      <td>Expired</td>
      <td><asp:Label id="ExpiredLabel" runat="Server"
 /></td>
    </tr>
    <tr>
      <td>Version</td>
      <td><asp:Label id="VersionLabel" runat="Server"
 /></td>
    </tr>
    <tr>
      <td>IssueDate</td>
      <td><asp:Label id="IssueDateLabel" runat="Server"
 /></td>
    </tr>
    <tr>
      <td>ExpireDate</td>
      <td><asp:Label id="ExpireDateLabel" runat="Server"
 /></td>
    </tr>
    <tr>
      <td>CookiePath</td>
      <td><asp:Label id="CookiePathLabel" runat="Server"
 /></td>
    </tr>
  </table>

</form>


</body>
</html>