RolePrincipal Konstruktory

Definicja

Przestrzeń nazw:

System.Web.Security

Zestaw:

System.Web.dll

Tworzy nowe wystąpienie klasy RolePrincipal.

Przeciążenia

RolePrincipal(IIdentity)	RolePrincipal Tworzy wystąpienie obiektu dla określonego identityobiektu .
RolePrincipal(SerializationInfo, StreamingContext)	Inicjuje RolePrincipal nowe wystąpienie klasy przy użyciu informacji zawartych w określonym SerializationInfo obiekcie i przy użyciu określonego kontekstu przesyłania strumieniowego.
RolePrincipal(IIdentity, String)	RolePrincipal Tworzy wystąpienie obiektu określonego identity z informacjami o roli z określonego encryptedTicketobiektu .
RolePrincipal(String, IIdentity)	RolePrincipal Tworzy wystąpienie obiektu dla określonego identity przy użyciu określonego providerNameobiektu .
RolePrincipal(String, IIdentity, String)	RolePrincipal Tworzy wystąpienie obiektu dla określonego identity przy użyciu określonych informacji o określonej providerName roli i z określonego encryptedTicketobiektu .

RolePrincipal(IIdentity)

RolePrincipal Tworzy wystąpienie obiektu dla określonego identityobiektu .

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)

Parametry

identity

IIdentity

Tożsamość użytkownika do utworzenia RolePrincipal elementu for.

Wyjątki

ArgumentNullException

identity to null.

Przykłady

Poniższy przykład kodu tworzy nowy RolePrincipal obiekt. Jeśli CacheRolesInCookie jest to true, przykład tworzy RolePrincipal element z informacjami o plikach cookie z pliku cookie zidentyfikowanego przez CookieName właściwość.

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

Uwagi

To przeciążenie konstruktora RolePrincipal tworzy nowy RolePrincipal obiekt i inicjuje jego wartości właściwości. Buforowane informacje o roli nie są odczytywane z pliku cookie identyfikowanego przez CookieName właściwość. Właściwość ProviderName jest ustawiona na Name domyślnego dostawcę roli.

Aby uzyskać informacje na temat włączania zarządzania rolami, zobacz klasę Roles .

Zobacz też

• Zarządzanie autoryzacją przy użyciu ról ASP.NET

RolePrincipal(SerializationInfo, StreamingContext)

Inicjuje RolePrincipal nowe wystąpienie klasy przy użyciu informacji zawartych w określonym SerializationInfo obiekcie i przy użyciu określonego kontekstu przesyłania strumieniowego.

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)

Parametry

info

SerializationInfo

Obiekt SerializationInfo, który ma zostać wypełniony przy użyciu danych.

context

StreamingContext

Lokalizacja docelowa tej serializacji.

RolePrincipal(IIdentity, String)

RolePrincipal Tworzy wystąpienie obiektu określonego identity z informacjami o roli z określonego encryptedTicketobiektu .

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)

Parametry

identity

IIdentity

Tożsamość użytkownika do utworzenia RolePrincipal elementu for.

encryptedTicket

String

Ciąg zawierający zaszyfrowane informacje o roli.

Wyjątki

ArgumentNullException

identity to null.

-lub-

encryptedTicket to null.

Przykłady

Poniższy przykład kodu tworzy nowy RolePrincipal obiekt. Jeśli CacheRolesInCookie jest to true, przykład tworzy RolePrincipal element z informacjami o plikach cookie z pliku cookie zidentyfikowanego przez CookieName właściwość.

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

Uwagi

Ważne

Użycie wystąpienia tego obiektu z niezaufanymi danymi jest zagrożeniem bezpieczeństwa. Użyj tego obiektu tylko z zaufanymi danymi. Aby uzyskać więcej informacji, zobacz Weryfikowanie wszystkich danych wejściowych.

To przeciążenie konstruktora RolePrincipal tworzy nowy RolePrincipal obiekt i inicjuje jego wartości właściwości. Informacje o roli bieżącego użytkownika są odczytywane z dostarczonego encryptedTicket i buforowanego obiektu RolePrincipal . Właściwość ProviderName jest ustawiona na Name domyślnego dostawcę roli.

Aby uzyskać informacje na temat włączania zarządzania rolami, zobacz klasę Roles .

Zobacz też

• Zarządzanie autoryzacją przy użyciu ról ASP.NET

RolePrincipal(String, IIdentity)

RolePrincipal Tworzy wystąpienie obiektu dla określonego identity przy użyciu określonego providerNameobiektu .

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)

Parametry

providerName

String

Nazwa dostawcy roli dla użytkownika.

identity

IIdentity

Tożsamość użytkownika do utworzenia RolePrincipal elementu for.

Wyjątki

ArgumentNullException

identity to null.

ArgumentException

providerName to null.

-lub-

providerName odwołuje się do dostawcy ról, który nie istnieje w konfiguracji aplikacji.

Uwagi

To przeciążenie konstruktora RolePrincipal tworzy nowy RolePrincipal obiekt i inicjuje jego wartości właściwości. Właściwość ProviderName jest ustawiona na wartość określoną w parametrze providerName .

Aby uzyskać informacje na temat włączania zarządzania rolami, zobacz klasę Roles .

Zobacz też

• Zarządzanie autoryzacją przy użyciu ról ASP.NET

RolePrincipal(String, IIdentity, String)

RolePrincipal Tworzy wystąpienie obiektu dla określonego identity przy użyciu określonych informacji o określonej providerName roli i z określonego encryptedTicketobiektu .

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)

Parametry

providerName

String

Nazwa dostawcy roli dla użytkownika.

identity

IIdentity

Tożsamość użytkownika do utworzenia RolePrincipal elementu for.

encryptedTicket

String

Ciąg zawierający zaszyfrowane informacje o roli.

Wyjątki

ArgumentNullException

identity to null.

-lub-

encryptedTicket to null.

ArgumentException

providerName to null.

-lub-

providerName odwołuje się do dostawcy ról, który nie istnieje w konfiguracji aplikacji.

Uwagi

Ważne

Użycie wystąpienia tego obiektu z niezaufanymi danymi jest zagrożeniem bezpieczeństwa. Użyj tego obiektu tylko z zaufanymi danymi. Aby uzyskać więcej informacji, zobacz Weryfikowanie wszystkich danych wejściowych.

To przeciążenie konstruktora RolePrincipal tworzy nowy RolePrincipal obiekt i inicjuje jego wartości właściwości. Informacje o roli bieżącego użytkownika są odczytywane z dostarczonego encryptedTicket i buforowanego obiektu RolePrincipal . Właściwość ProviderName jest ustawiona na wartość określoną w parametrze providerName .

Aby uzyskać informacje na temat włączania zarządzania rolami, zobacz klasę Roles .

Zobacz też

• Zarządzanie autoryzacją przy użyciu ról ASP.NET