RolePrincipal コンストラクター

リファレンス

定義

名前空間:: System.Web.Security

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

RolePrincipal(IIdentity)	指定された `identity` の RolePrincipal オブジェクトのインスタンスを作成します。
RolePrincipal(SerializationInfo, StreamingContext)	指定された RolePrincipal オブジェクトに格納されている情報、および指定されたストリーミングコンテキストを使用して、SerializationInfo クラスの新しいインスタンスを初期化します。
RolePrincipal(IIdentity, String)	指定された `identity` のロール情報を使用して、指定された `encryptedTicket` の RolePrincipal オブジェクトのインスタンスを生成します。
RolePrincipal(String, IIdentity)	指定した `identity` を使用して、指定した `providerName` の RolePrincipal オブジェクトのインスタンスを作成します。
RolePrincipal(String, IIdentity, String)	指定された `identity` のロール情報と `providerName` を使用して、指定された `encryptedTicket` の RolePrincipal オブジェクトのインスタンスを作成します。

RolePrincipal(IIdentity)

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

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。

例外

ArgumentNullException

identity が nullです。

例

次のコード例では、新 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

注釈

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

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

こちらもご覧ください

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

適用対象

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 のロール情報を使用して、指定された encryptedTicket の RolePrincipal オブジェクトのインスタンスを生成します。

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

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

例外

ArgumentNullException

identity が nullです。

または

encryptedTicket は null です。

例

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

注釈

重要

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

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

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

こちらもご覧ください

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

適用対象

RolePrincipal(String, IIdentity)

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

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。

例外

ArgumentNullException

identity は null です。

ArgumentException

providerName は null です。

- または -

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

注釈

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

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

こちらもご覧ください

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

適用対象

RolePrincipal(String, IIdentity, String)

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

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

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

例外

ArgumentNullException

identity は null です。

または

encryptedTicket は null です。

ArgumentException

providerName は null です。

- または -

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

注釈

重要

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

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

こちらもご覧ください

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

適用対象

次の方法で共有

RolePrincipal コンストラクター

定義

オーバーロード

RolePrincipal(IIdentity)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

RolePrincipal(SerializationInfo, StreamingContext)

パラメーター

適用対象

RolePrincipal(IIdentity, String)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

RolePrincipal(String, IIdentity)

パラメーター

例外

注釈

こちらもご覧ください

適用対象

RolePrincipal(String, IIdentity, String)

パラメーター

例外

注釈

こちらもご覧ください

適用対象

その他のリソース