RolePrincipal.ToEncryptedTicket メソッド

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

RolePrincipal.ToEncryptedTicket メソッド

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

CookieProtectionValue に基づいて暗号化されている RolePrincipal オブジェクトを使用してキャッシュされたロール情報を返します。

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

Visual Basic (宣言)

Public Function ToEncryptedTicket As
 String

Visual Basic (使用法)

Dim instance As RolePrincipal
Dim returnValue As String

returnValue = instance.ToEncryptedTicket

C#

public string ToEncryptedTicket ()

C++

public:
String^ ToEncryptedTicket ()

J#

public String ToEncryptedTicket ()

JScript

public function ToEncryptedTicket () : String

戻り値
CookieProtectionValue に基づいて暗号化されている RolePrincipal オブジェクトを使用してキャッシュされたロール情報。

解説

CacheRolesInCookie が true の場合、ToEncryptedTicket メソッドが返す値はロール Cookie に保存されます。

使用例

ToEncryptedTicket メソッドの結果をロール Cookie に書き込むコード例を次に示します。

Visual Basic

Try
  Dim r As RolePrincipal = CType(User, RolePrincipal)
  Dim eTicket As String
 = r.ToEncryptedTicket()
  Dim cookie As HttpCookie = New
 HttpCookie(Roles.CookieName, eTicket)
  cookie.Path = Roles.CookiePath
  cookie.Expires = r.ExpireDate
  Response.Cookies.Add(cookie)
Catch e As InvalidCastException
  Response.Write("User is not of type RolePrincipal. Are roles
 enabled?")
End Try

C#

try
{
  RolePrincipal r = (RolePrincipal)User;
  string eTicket = r.ToEncryptedTicket();
  HttpCookie cookie = new HttpCookie(Roles.CookieName, eTicket);
  cookie.Path = Roles.CookiePath;
  cookie.Expires = r.ExpireDate;
  Response.Cookies.Add(cookie);
}
catch (InvalidCastException)
{
  Response.Write("User is not of type RolePrincipal. Are roles enabled?");
}

プラットフォーム

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

参照

関連項目
RolePrincipal クラス
RolePrincipal メンバ
System.Web.Security 名前空間
その他の技術情報
ロールを使用した承認の管理