RolePrincipal Konstruktor

Definisi

Ruang nama:

System.Web.Security

Rakitan:

System.Web.dll

Membuat instans RolePrincipal baru kelas .

Overload

RolePrincipal(IIdentity)	Membuat instans RolePrincipal objek untuk yang ditentukan identity.
RolePrincipal(SerializationInfo, StreamingContext)	Menginisialisasi instans RolePrincipal baru kelas menggunakan informasi yang terkandung dalam objek yang ditentukan SerializationInfo dan menggunakan konteks streaming yang ditentukan.
RolePrincipal(IIdentity, String)	Membuat instans RolePrincipal objek untuk yang ditentukan identity dengan informasi peran dari yang ditentukan encryptedTicket.
RolePrincipal(String, IIdentity)	Membuat instans RolePrincipal objek untuk yang ditentukan identity menggunakan yang ditentukan providerName.
RolePrincipal(String, IIdentity, String)	Membuat instans RolePrincipal objek untuk yang ditentukan identity menggunakan informasi peran dan yang ditentukan providerName dari yang ditentukan encryptedTicket.

RolePrincipal(IIdentity)

Membuat instans RolePrincipal objek untuk yang ditentukan identity.

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)

Parameter

identity

IIdentity

Identitas pengguna untuk membuat RolePrincipal untuk.

Pengecualian

ArgumentNullException

identityadalah null.

Contoh

Contoh kode berikut membuat objek baru RolePrincipal . Jika CacheRolesInCookie adalah true, contohnya membuat RolePrincipal informasi dengan cookie dari cookie yang diidentifikasi oleh CookieName properti .

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

Keterangan

Kelebihan beban RolePrincipal konstruktor ini membuat objek baru RolePrincipal dan menginisialisasi nilai propertinya. Informasi peran yang di-cache tidak dibaca dari cookie yang diidentifikasi oleh CookieName properti . Properti ProviderName diatur ke Name penyedia peran default.

Untuk informasi tentang mengaktifkan manajemen peran, lihat Roles kelas .

Lihat juga

• Mengelola Otorisasi Menggunakan Peran ASP.NET

RolePrincipal(SerializationInfo, StreamingContext)

Menginisialisasi instans RolePrincipal baru kelas menggunakan informasi yang terkandung dalam objek yang ditentukan SerializationInfo dan menggunakan konteks streaming yang ditentukan.

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)

Parameter

info

SerializationInfo

Objek SerializationInfo untuk diisi dengan data.

context

StreamingContext

Tujuan untuk serialisasi ini.

RolePrincipal(IIdentity, String)

Membuat instans RolePrincipal objek untuk yang ditentukan identity dengan informasi peran dari yang ditentukan encryptedTicket.

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)

Parameter

identity

IIdentity

Identitas pengguna untuk membuat RolePrincipal untuk.

encryptedTicket

String

String yang berisi informasi peran terenkripsi.

Pengecualian

ArgumentNullException

identityadalah null.

-atau-

encryptedTicketadalah null.

Contoh

Contoh kode berikut membuat objek baru RolePrincipal . Jika CacheRolesInCookie adalah true, contohnya membuat RolePrincipal informasi dengan cookie dari cookie yang diidentifikasi oleh CookieName properti .

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

Keterangan

Penting

Menggunakan instans objek ini dengan data yang tidak tepercaya adalah risiko keamanan. Gunakan objek ini hanya dengan data tepercaya. Untuk informasi selengkapnya, lihat Memvalidasi Semua Input.

Kelebihan beban RolePrincipal konstruktor ini membuat objek baru RolePrincipal dan menginisialisasi nilai propertinya. Informasi peran untuk pengguna saat ini dibaca dari yang disediakan encryptedTicket dan di-cache dengan RolePrincipal objek . Properti ProviderName diatur ke Name penyedia peran default.

Untuk informasi tentang mengaktifkan manajemen peran, lihat Roles kelas .

Lihat juga

• Mengelola Otorisasi Menggunakan Peran ASP.NET

RolePrincipal(String, IIdentity)

Membuat instans RolePrincipal objek untuk yang ditentukan identity menggunakan yang ditentukan providerName.

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)

Parameter

providerName

String

Nama penyedia peran untuk pengguna.

identity

IIdentity

Identitas pengguna untuk membuat RolePrincipal untuk.

Pengecualian

ArgumentNullException

identityadalah null.

ArgumentException

providerNameadalah null.

-atau-

providerName mengacu pada penyedia peran yang tidak ada dalam konfigurasi untuk aplikasi.

Keterangan

Kelebihan beban RolePrincipal konstruktor ini membuat objek baru RolePrincipal dan menginisialisasi nilai propertinya. Properti ProviderName diatur ke nilai yang ditentukan dalam providerName parameter .

Untuk informasi tentang mengaktifkan manajemen peran, lihat Roles kelas .

Lihat juga

• Mengelola Otorisasi Menggunakan Peran ASP.NET

RolePrincipal(String, IIdentity, String)

Membuat instans RolePrincipal objek untuk yang ditentukan identity menggunakan informasi peran dan yang ditentukan providerName dari yang ditentukan encryptedTicket.

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)

Parameter

providerName

String

Nama penyedia peran untuk pengguna.

identity

IIdentity

Identitas pengguna untuk membuat RolePrincipal untuk.

encryptedTicket

String

String yang berisi informasi peran terenkripsi.

Pengecualian

ArgumentNullException

identityadalah null.

-atau-

encryptedTicketadalah null.

ArgumentException

providerNameadalah null.

-atau-

providerName mengacu pada penyedia peran yang tidak ada dalam konfigurasi untuk aplikasi.

Keterangan

Penting

Menggunakan instans objek ini dengan data yang tidak tepercaya adalah risiko keamanan. Gunakan objek ini hanya dengan data tepercaya. Untuk informasi selengkapnya, lihat Memvalidasi Semua Input.

Kelebihan beban RolePrincipal konstruktor ini membuat objek baru RolePrincipal dan menginisialisasi nilai propertinya. Informasi peran untuk pengguna saat ini dibaca dari yang disediakan encryptedTicket dan di-cache dengan RolePrincipal objek . Properti ProviderName diatur ke nilai yang ditentukan dalam providerName parameter .

Untuk informasi tentang mengaktifkan manajemen peran, lihat Roles kelas .

Lihat juga

• Mengelola Otorisasi Menggunakan Peran ASP.NET