RolePrincipal コンストラクタ

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

RolePrincipal コンストラクタ (IIdentity, String)

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

指定された encryptedTicket のロール情報を使用して、指定された identity の RolePrincipal オブジェクトのインスタンスを生成します。

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

Visual Basic (宣言)

Public Sub New ( _
    identity As IIdentity, _
    encryptedTicket As String _
)

Visual Basic (使用法)

Dim identity As IIdentity
Dim encryptedTicket As String

Dim instance As New RolePrincipal(identity,
 encryptedTicket)

C#

public RolePrincipal (
    IIdentity identity,
    string encryptedTicket
)

C++

public:
RolePrincipal (
    IIdentity^ identity, 
    String^ encryptedTicket
)

J#

public RolePrincipal (
    IIdentity identity, 
    String encryptedTicket
)

JScript

public function RolePrincipal (
    identity : IIdentity, 
    encryptedTicket : String
)

パラメータ

identity

RolePrincipal の作成対象となるユーザーの ID。

encryptedTicket

暗号化されたロール情報を格納する文字列。

例外

例外の種類	条件
System.ArgumentNullException	identity が null 参照 (Visual Basic では Nothing) です。 または encryptedTicket が null 参照 (Visual Basic では Nothing) です。

解説

RolePrincipal コンストラクタのこのオーバーロードは RolePrincipal オブジェクトを新規作成して、そのプロパティ値を初期化します。提供されている encryptedTicket から現在のユーザーのロール情報が読み出され、RolePrincipal オブジェクトを使用してキャッシュされます。ProviderName プロパティは、既定のロール プロバイダの Name に設定されます。

ロール管理の有効化の詳細については、Roles クラスのトピックを参照してください。

使用例

新しい RolePrincipal を作成するコード例を次に示します。CacheRolesInCookie が true の場合、この例は CookieName プロパティによって指定される Cookie の情報を使用して RolePrincipal を作成します。

Visual Basic

Dim r As RolePrincipal

If Roles.CacheRolesInCookie Then
  Dim roleCookie As String
 = ""

  Dim cookie As HttpCookie = HttpContext.Current.Request.Cookies(Roles.CookieName)
  If Not cookie Is Nothing
 Then roleCookie = cookie.Value

  r = New RolePrincipal(User.Identity, roleCookie)
Else
  r = new RolePrincipal(User.Identity)
End If

C#

RolePrincipal r;

if (Roles.CacheRolesInCookie)
{
  string roleCookie = "";

  HttpCookie cookie = HttpContext.Current.Request.Cookies[Roles.CookieName];
  if (cookie != null) { roleCookie = cookie.Value;
 }

  r = new RolePrincipal(User.Identity, roleCookie);
}
else
{
  r = new RolePrincipal(User.Identity);
}

プラットフォーム

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 名前空間
その他の技術情報
ロールを使用した承認の管理

RolePrincipal コンストラクタ (String, IIdentity)

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

指定した providerName を使用して、指定した identity の RolePrincipal オブジェクトのインスタンスを作成します。

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

Visual Basic (宣言)

Public Sub New ( _
    providerName As String, _
    identity As IIdentity _
)

Visual Basic (使用法)

Dim providerName As String
Dim identity As IIdentity

Dim instance As New RolePrincipal(providerName,
 identity)

C#

public RolePrincipal (
    string providerName,
    IIdentity identity
)

C++

public:
RolePrincipal (
    String^ providerName, 
    IIdentity^ identity
)

J#

public RolePrincipal (
    String providerName, 
    IIdentity identity
)

JScript

public function RolePrincipal (
    providerName : String, 
    identity : IIdentity
)

パラメータ

providerName

ユーザーのロール プロバイダの名前。

identity

RolePrincipal を作成するユーザーの ID。

例外

例外の種類	条件
System.ArgumentNullException	identity が null 参照 (Visual Basic では Nothing) です。
System.ArgumentException	providerName が null 参照 (Visual Basic では Nothing) です。 または providerName が、アプリケーションの構成に存在しないロール プロバイダを参照しています。

解説

RolePrincipal コンストラクタのこのオーバーロードは RolePrincipal オブジェクトを新規作成して、そのプロパティ値を初期化します。ProviderName プロパティは providerName パラメータに指定された値に設定されます。

ロール管理の有効化の詳細については、Roles クラスのトピックを参照してください。

プラットフォーム

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 名前空間
その他の技術情報
ロールを使用した承認の管理

RolePrincipal コンストラクタ (String, IIdentity, String)

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

指定された encryptedTicket のロール情報と providerName を使用して、指定された identity の RolePrincipal オブジェクトのインスタンスを作成します。

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

Visual Basic (宣言)

Public Sub New ( _
    providerName As String, _
    identity As IIdentity, _
    encryptedTicket As String _
)

Visual Basic (使用法)

Dim providerName As String
Dim identity As IIdentity
Dim encryptedTicket As String

Dim instance As New RolePrincipal(providerName,
 identity, encryptedTicket)

C#

public RolePrincipal (
    string providerName,
    IIdentity identity,
    string encryptedTicket
)

C++

public:
RolePrincipal (
    String^ providerName, 
    IIdentity^ identity, 
    String^ encryptedTicket
)

J#

public RolePrincipal (
    String providerName, 
    IIdentity identity, 
    String encryptedTicket
)

JScript

public function RolePrincipal (
    providerName : String, 
    identity : IIdentity, 
    encryptedTicket : String
)

パラメータ

providerName

ユーザーのロール プロバイダの名前。

identity

RolePrincipal の作成対象となるユーザーの ID。

encryptedTicket

暗号化されたロール情報を格納する文字列。

例外

例外の種類	条件
System.ArgumentNullException	identity が null 参照 (Visual Basic では Nothing) です。 または encryptedTicket が null 参照 (Visual Basic では Nothing) です。
System.ArgumentException	providerName が null 参照 (Visual Basic では Nothing) です。 または providerName が、アプリケーションの構成に存在しないロール プロバイダを参照しています。

解説

RolePrincipal コンストラクタのこのオーバーロードは RolePrincipal オブジェクトを新規作成して、そのプロパティ値を初期化します。提供されている encryptedTicket から現在のユーザーのロール情報が読み出され、RolePrincipal オブジェクトを使用してキャッシュされます。ProviderName プロパティは providerName パラメータに指定された値に設定されます。

ロール管理の有効化の詳細については、Roles クラスのトピックを参照してください。

プラットフォーム

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 名前空間
その他の技術情報
ロールを使用した承認の管理

RolePrincipal コンストラクタ (IIdentity)

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

指定された identity の RolePrincipal オブジェクトのインスタンスを作成します。

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

Visual Basic (宣言)

Public Sub New ( _
    identity As IIdentity _
)

Visual Basic (使用法)

Dim identity As IIdentity

Dim instance As New RolePrincipal(identity)

C#

public RolePrincipal (
    IIdentity identity
)

C++

public:
RolePrincipal (
    IIdentity^ identity
)

J#

public RolePrincipal (
    IIdentity identity
)

JScript

public function RolePrincipal (
    identity : IIdentity
)

パラメータ

identity

RolePrincipal を作成するユーザーの ID。

例外

例外の種類	条件
System.ArgumentNullException	identity が null 参照 (Visual Basic では Nothing) です。

解説

RolePrincipal コンストラクタのこのオーバーロードは RolePrincipal オブジェクトを新規作成して、そのプロパティ値を初期化します。キャッシュされたロール情報は CookieName プロパティで指定される Cookie から読み込まれません。ProviderName プロパティは、既定のロール プロバイダの Name に設定されます。

ロール管理の有効化の詳細については、Roles クラスのトピックを参照してください。

使用例

新しい RolePrincipal を作成するコード例を次に示します。CacheRolesInCookie が true の場合、この例は CookieName プロパティによって指定される Cookie の情報を使用して RolePrincipal を作成します。

Visual Basic

Dim r As RolePrincipal

If Roles.CacheRolesInCookie Then
  Dim roleCookie As String
 = ""

  Dim cookie As HttpCookie = HttpContext.Current.Request.Cookies(Roles.CookieName)
  If Not cookie Is Nothing
 Then roleCookie = cookie.Value

  r = New RolePrincipal(User.Identity, roleCookie)
Else
  r = new RolePrincipal(User.Identity)
End If

C#

RolePrincipal r;

if (Roles.CacheRolesInCookie)
{
  string roleCookie = "";

  HttpCookie cookie = HttpContext.Current.Request.Cookies[Roles.CookieName];
  if (cookie != null) { roleCookie = cookie.Value;
 }

  r = new RolePrincipal(User.Identity, roleCookie);
}
else
{
  r = new RolePrincipal(User.Identity);
}

プラットフォーム

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 名前空間
その他の技術情報
ロールを使用した承認の管理
ロールを使用した承認の管理

RolePrincipal コンストラクタ

RolePrincipal クラスの新しいインスタンスを作成します。 ロールを使用した承認の管理
オーバーロードの一覧

名前	説明
RolePrincipal (IIdentity)	指定された identity の RolePrincipal オブジェクトのインスタンスを作成します。
RolePrincipal (IIdentity, String)	指定された encryptedTicket のロール情報を使用して、指定された identity の RolePrincipal オブジェクトのインスタンスを生成します。
RolePrincipal (String, IIdentity)	指定した providerName を使用して、指定した identity の RolePrincipal オブジェクトのインスタンスを作成します。
RolePrincipal (String, IIdentity, String)	指定された encryptedTicket のロール情報と providerName を使用して、指定された identity の RolePrincipal オブジェクトのインスタンスを作成します。

参照

関連項目

RolePrincipal クラス
RolePrincipal メンバ
System.Web.Security 名前空間

その他の技術情報

ロールを使用した承認の管理
ロールを使用した承認の管理