FormsAuthenticationEventArgs.User-Eigenschaft
Ruft das IPrincipal-Objekt ab, das der aktuellen Anforderung zugeordnet werden soll, oder legt dieses fest.
Namespace: System.Web.Security
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Property User As IPrincipal
'Usage
Dim instance As FormsAuthenticationEventArgs
Dim value As IPrincipal
value = instance.User
instance.User = value
public IPrincipal User { get; set; }
public:
property IPrincipal^ User {
IPrincipal^ get ();
void set (IPrincipal^ value);
}
/** @property */
public IPrincipal get_User ()
/** @property */
public void set_User (IPrincipal value)
public function get User () : IPrincipal
public function set User (value : IPrincipal)
Eigenschaftenwert
Das IPrincipal-Objekt, das mit der aktuellen Anforderung verknüpft werden soll.
Hinweise
Sie können die User-Eigenschaft des aktuellen HttpContext mit der User-Eigenschaft auf ein benutzerdefiniertes IPrincipal-Objekt festlegen.
Wenn Sie während des FormsAuthentication_OnAuthenticate-Ereignisses keinen Wert für die User-Eigenschaft angeben, wird die vom Formularauthentifizierungsticket im Cookie oder im URL bereitgestellte Identität verwendet.
Beispiel
Im folgenden Beispiel wird mithilfe des FormsAuthentication_OnAuthenticate-Ereignisses die User-Eigenschaft des aktuellen HttpContext auf ein GenericPrincipal-Objekt mit einer benutzerdefinierten Identity festgelegt.
Public Sub FormsAuthentication_OnAuthenticate(sender As Object, _
args As FormsAuthenticationEventArgs)
If FormsAuthentication.CookiesSupported Then
If Not Request.Cookies(FormsAuthentication.FormsCookieName) Is Nothing Then
Try
Dim ticket As FormsAuthenticationTicket = FormsAuthentication.Decrypt( _
Request.Cookies(FormsAuthentication.FormsCookieName).Value)
args.User = New System.Security.Principal.GenericPrincipal( _
New Samples.AspNet.Security.MyFormsIdentity(ticket), _
New String(0) {})
Catch e As HttpException
' Decrypt method failed.
End Try
End If
Else
Throw New Exception("Cookieless Forms Authentication is not " & _
"supported for this application.")
End If
End Sub
public void FormsAuthentication_OnAuthenticate(object sender, FormsAuthenticationEventArgs args)
{
if (FormsAuthentication.CookiesSupported)
{
if (Request.Cookies[FormsAuthentication.FormsCookieName] != null)
{
try
{
FormsAuthenticationTicket ticket = FormsAuthentication.Decrypt(
Request.Cookies[FormsAuthentication.FormsCookieName].Value);
args.User = new System.Security.Principal.GenericPrincipal(
new Samples.AspNet.Security.MyFormsIdentity(ticket),
new string[0]);
}
catch (Exception e)
{
// Decrypt method failed.
}
}
}
else
{
throw new HttpException("Cookieless Forms Authentication is not " +
"supported for this application.");
}
}
.NET Framework-Sicherheit
- SecurityPermission zum Festlegen des User-Eigenschaftenwerts. Anforderungswert: Demand. Berechtigungswert: ControlPrincipal.
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
FormsAuthenticationEventArgs-Klasse
FormsAuthenticationEventArgs-Member
System.Web.Security-Namespace