次の方法で共有


RolePrincipal コンストラクター

定義

RolePrincipal クラスの新しいインスタンスを作成します。

オーバーロード

RolePrincipal(IIdentity)

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

RolePrincipal(SerializationInfo, StreamingContext)

指定された RolePrincipal オブジェクトに格納されている情報、および指定されたストリーミング コンテキストを使用して、SerializationInfo クラスの新しいインスタンスを初期化します。

RolePrincipal(IIdentity, String)

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

RolePrincipal(String, IIdentity)

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

RolePrincipal(String, IIdentity, String)

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

RolePrincipal(IIdentity)

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

public:
 RolePrincipal(System::Security::Principal::IIdentity ^ identity);
public RolePrincipal (System.Security.Principal.IIdentity identity);
new System.Web.Security.RolePrincipal : System.Security.Principal.IIdentity -> System.Web.Security.RolePrincipal
Public Sub New (identity As IIdentity)

パラメーター

identity
IIdentity

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

例外

identitynullです。

次のコード例では、新 RolePrincipal しい オブジェクトを作成します。 が の場合CacheRolesInCookie、この例では、 プロパティによって識別される Cookie からの Cookie 情報を使用して をCookieName作成RolePrincipalします。true

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);
}
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

注釈

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

ロール管理を有効にする方法については、 クラスを Roles 参照してください。

こちらもご覧ください

適用対象

RolePrincipal(SerializationInfo, StreamingContext)

指定された RolePrincipal オブジェクトに格納されている情報、および指定されたストリーミング コンテキストを使用して、SerializationInfo クラスの新しいインスタンスを初期化します。

protected:
 RolePrincipal(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
protected RolePrincipal (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new System.Web.Security.RolePrincipal : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Web.Security.RolePrincipal
Protected Sub New (info As SerializationInfo, context As StreamingContext)

パラメーター

info
SerializationInfo

データを読み込む先の SerializationInfo オブジェクト。

context
StreamingContext

このシリアル化のシリアル化先。

適用対象

RolePrincipal(IIdentity, String)

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

public:
 RolePrincipal(System::Security::Principal::IIdentity ^ identity, System::String ^ encryptedTicket);
public RolePrincipal (System.Security.Principal.IIdentity identity, string encryptedTicket);
new System.Web.Security.RolePrincipal : System.Security.Principal.IIdentity * string -> System.Web.Security.RolePrincipal
Public Sub New (identity As IIdentity, encryptedTicket As String)

パラメーター

identity
IIdentity

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

encryptedTicket
String

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

例外

identitynullです。

または

encryptedTicketnull です。

次のコード例では、新 RolePrincipal しい オブジェクトを作成します。 が の場合CacheRolesInCookie、この例では、 プロパティによって識別される Cookie からの Cookie 情報を使用して をCookieName作成RolePrincipalします。true

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);
}
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

注釈

重要

信頼されていないデータを指定してこのオブジェクトのインスタンスを使用することは、セキュリティ上のリスクが伴います。 このオブジェクトは信頼されたデータでのみ使用してください。 詳細については、「 すべての入力を検証する」を参照してください。

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

ロール管理を有効にする方法については、 クラスを Roles 参照してください。

こちらもご覧ください

適用対象

RolePrincipal(String, IIdentity)

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

public:
 RolePrincipal(System::String ^ providerName, System::Security::Principal::IIdentity ^ identity);
public RolePrincipal (string providerName, System.Security.Principal.IIdentity identity);
new System.Web.Security.RolePrincipal : string * System.Security.Principal.IIdentity -> System.Web.Security.RolePrincipal
Public Sub New (providerName As String, identity As IIdentity)

パラメーター

providerName
String

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

identity
IIdentity

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

例外

identitynull です。

providerNamenull です。

- または -

providerName が、アプリケーションの構成に存在しないロール プロバイダーを参照しています。

注釈

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

ロール管理を有効にする方法については、 クラスを Roles 参照してください。

こちらもご覧ください

適用対象

RolePrincipal(String, IIdentity, String)

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

public:
 RolePrincipal(System::String ^ providerName, System::Security::Principal::IIdentity ^ identity, System::String ^ encryptedTicket);
public RolePrincipal (string providerName, System.Security.Principal.IIdentity identity, string encryptedTicket);
new System.Web.Security.RolePrincipal : string * System.Security.Principal.IIdentity * string -> System.Web.Security.RolePrincipal
Public Sub New (providerName As String, identity As IIdentity, encryptedTicket As String)

パラメーター

providerName
String

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

identity
IIdentity

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

encryptedTicket
String

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

例外

identitynull です。

または

encryptedTicketnull です。

providerNamenull です。

- または -

providerName が、アプリケーションの構成に存在しないロール プロバイダーを参照しています。

注釈

重要

信頼されていないデータを指定してこのオブジェクトのインスタンスを使用することは、セキュリティ上のリスクが伴います。 このオブジェクトは信頼されたデータでのみ使用してください。 詳細については、「 すべての入力を検証する」を参照してください。

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

ロール管理を有効にする方法については、 クラスを Roles 参照してください。

こちらもご覧ください

適用対象