RolePrincipal Oluşturucular

Tanım

Ad Alanı:

System.Web.Security

Bütünleştirilmiş Kod:

System.Web.dll

RolePrincipal sınıfının yeni bir örneğini oluşturur.

Aşırı Yüklemeler

RolePrincipal(IIdentity)	Belirtilen identityiçin bir RolePrincipal nesnesi örneği oluşturur.
RolePrincipal(SerializationInfo, StreamingContext)	Belirtilen nesnede RolePrincipal bulunan bilgileri kullanarak ve belirtilen SerializationInfo akış bağlamını kullanarak sınıfının yeni bir örneğini başlatır.
RolePrincipal(IIdentity, String)	Belirtilen öğesinden rol bilgileriyle belirtilen identity için bir RolePrincipal nesnesi örneği encryptedTicketoluşturur.
RolePrincipal(String, IIdentity)	Belirtilen kullanılarak belirtilen identity için bir RolePrincipal nesnesi örneği providerNameoluşturur.
RolePrincipal(String, IIdentity, String)	Belirtilen öğesinden belirtilen identityproviderName ve rol bilgilerini kullanarak belirtilen için bir RolePrincipal nesnesi örneği encryptedTicketoluşturur.

RolePrincipal(IIdentity)

Belirtilen identityiçin bir RolePrincipal nesnesi örneği oluşturur.

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)

Parametreler

identity

IIdentity

Oluşturulacak RolePrincipal kullanıcı kimliği.

Özel durumlar

ArgumentNullException

identity, null değeridir.

Örnekler

Aşağıdaki kod örneği yeni RolePrincipal bir nesne oluşturur. ise CacheRolesInCookietrue, örnek özelliği tarafından CookieName tanımlanan tanımlama bilgisinden tanımlama bilgisi bilgileriyle öğesini oluştururRolePrincipal.

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

Açıklamalar

Oluşturucunun RolePrincipal bu aşırı yüklemesi yeni RolePrincipal bir nesne oluşturur ve özellik değerlerini başlatır. Önbelleğe alınan rol bilgileri özelliği tarafından CookieName tanımlanan tanımlama bilgisinden okunmuyor. ProviderName özelliği, varsayılan rol sağlayıcısının değerine ayarlanırName.

Rol yönetimini etkinleştirme hakkında bilgi için sınıfına Roles bakın.

Ayrıca bkz.

• ASP.NET Rolleri Kullanarak Yetkilendirmeyi Yönetme

RolePrincipal(SerializationInfo, StreamingContext)

Belirtilen nesnede RolePrincipal bulunan bilgileri kullanarak ve belirtilen SerializationInfo akış bağlamını kullanarak sınıfının yeni bir örneğini başlatır.

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)

Parametreler

info

SerializationInfo

Veri ile doldurulacak SerializationInfo nesnesi.

context

StreamingContext

Bu serileştirmenin hedefi.

RolePrincipal(IIdentity, String)

Belirtilen öğesinden rol bilgileriyle belirtilen identity için bir RolePrincipal nesnesi örneği encryptedTicketoluşturur.

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)

Parametreler

identity

IIdentity

Oluşturulacak RolePrincipal kullanıcı kimliği.

encryptedTicket

String

Şifrelenmiş rol bilgilerini içeren bir dize.

Özel durumlar

ArgumentNullException

identity, null değeridir.

-veya-

encryptedTicket, null değeridir.

Örnekler

Aşağıdaki kod örneği yeni RolePrincipal bir nesne oluşturur. ise CacheRolesInCookietrue, örnek özelliği tarafından CookieName tanımlanan tanımlama bilgisinden tanımlama bilgisi bilgileriyle öğesini oluştururRolePrincipal.

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

Açıklamalar

Önemli

Güvenilmeyen verilerle bu nesnenin bir örneğini kullanmak bir güvenlik riskidir. Bu nesneyi yalnızca güvenilen verilerle kullanın. Daha fazla bilgi için bkz. Tüm Girişleri Doğrulama.

Oluşturucunun RolePrincipal bu aşırı yüklemesi yeni RolePrincipal bir nesne oluşturur ve özellik değerlerini başlatır. Geçerli kullanıcının rol bilgileri sağlanandan encryptedTicket okunur ve nesnesiyle önbelleğe RolePrincipal alınır. ProviderName özelliği, varsayılan rol sağlayıcısının değerine ayarlanırName.

Rol yönetimini etkinleştirme hakkında bilgi için sınıfına Roles bakın.

Ayrıca bkz.

• ASP.NET Rolleri Kullanarak Yetkilendirmeyi Yönetme

RolePrincipal(String, IIdentity)

Belirtilen kullanılarak belirtilen identity için bir RolePrincipal nesnesi örneği providerNameoluşturur.

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)

Parametreler

providerName

String

Kullanıcının rol sağlayıcısının adı.

identity

IIdentity

Oluşturulacak RolePrincipal kullanıcı kimliği.

Özel durumlar

ArgumentNullException

identity, null değeridir.

ArgumentException

providerName, null değeridir.

-veya-

providerName , uygulamanın yapılandırmasında bulunmayan bir rol sağlayıcısını ifade eder.

Açıklamalar

Oluşturucunun RolePrincipal bu aşırı yüklemesi yeni RolePrincipal bir nesne oluşturur ve özellik değerlerini başlatır. ProviderName özelliği parametresinde belirtilen değere providerName ayarlanır.

Rol yönetimini etkinleştirme hakkında bilgi için sınıfına Roles bakın.

Ayrıca bkz.

• ASP.NET Rolleri Kullanarak Yetkilendirmeyi Yönetme

RolePrincipal(String, IIdentity, String)

Belirtilen öğesinden belirtilen identityproviderName ve rol bilgilerini kullanarak belirtilen için bir RolePrincipal nesnesi örneği encryptedTicketoluşturur.

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)

Parametreler

providerName

String

Kullanıcının rol sağlayıcısının adı.

identity

IIdentity

Oluşturulacak RolePrincipal kullanıcı kimliği.

encryptedTicket

String

Şifrelenmiş rol bilgilerini içeren bir dize.

Özel durumlar

ArgumentNullException

identity, null değeridir.

-veya-

encryptedTicket, null değeridir.

ArgumentException

providerName, null değeridir.

-veya-

providerName , uygulamanın yapılandırmasında bulunmayan bir rol sağlayıcısını ifade eder.

Açıklamalar

Önemli

Güvenilmeyen verilerle bu nesnenin bir örneğini kullanmak bir güvenlik riskidir. Bu nesneyi yalnızca güvenilen verilerle kullanın. Daha fazla bilgi için bkz. Tüm Girişleri Doğrulama.

Oluşturucunun RolePrincipal bu aşırı yüklemesi yeni RolePrincipal bir nesne oluşturur ve özellik değerlerini başlatır. Geçerli kullanıcının rol bilgileri sağlanandan encryptedTicket okunur ve nesnesiyle önbelleğe RolePrincipal alınır. ProviderName özelliği parametresinde belirtilen değere providerName ayarlanır.

Rol yönetimini etkinleştirme hakkında bilgi için sınıfına Roles bakın.

Ayrıca bkz.

• ASP.NET Rolleri Kullanarak Yetkilendirmeyi Yönetme