DefaultAuthenticationEventArgs(HttpContext) Konstruktor
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Initialisiert eine neue Instanz der DefaultAuthenticationEventArgs-Klasse.
public:
DefaultAuthenticationEventArgs(System::Web::HttpContext ^ context);public DefaultAuthenticationEventArgs(System.Web.HttpContext context);new System.Web.Security.DefaultAuthenticationEventArgs : System.Web.HttpContext -> System.Web.Security.DefaultAuthenticationEventArgsPublic Sub New (context As HttpContext)Parameter
- context
- HttpContext
Der Kontext für das Ereignis.
Beispiele
Im folgenden Codebeispiel wird das DefaultAuthentication_OnAuthenticate-Ereignis verwendet, um zu testen, ob die User Eigenschaft des aktuellen HttpContext Objekts ist null. Wenn die Eigenschaft lautet null, legt das Beispiel die User Eigenschaft des Aktuellen HttpContext auf ein GenericPrincipal Objekt fest, bei dem es sich bei der Identity Eigenschaft des GenericPrincipal Objekts um ein GenericIdentity Objekt mit dem Name Eigenschaftswert "default" handelt.
Hinweis
Das DefaultAuthentication_OnAuthenticate-Ereignis wird vor dem AuthorizeRequest Ereignis ausgelöst. Wenn Sie die User Eigenschaft des aktuellen HttpContext Objekts auf eine benutzerdefinierte Identität festlegen, kann dies sich auf das Verhalten Ihrer Anwendung auswirken. Wenn Sie beispielsweise die FormsAuthentication Klasse verwenden und sicherstellen, dass nur authentifizierte Benutzer Zugriff auf Ihre Website haben, indem Sie den authorization Abschnitt verwenden und angeben <deny users="?" />, führen Sie dazu, dass das deny Element in diesem Beispiel ignoriert wird, da der Benutzer einen Namen hat, der "Standard" lautet. Stattdessen geben <deny users="default" /> Sie an, dass nur authentifizierte Benutzer auf Ihre Website zugreifen können.
public void DefaultAuthentication_OnAuthenticate(object sender,
DefaultAuthenticationEventArgs args)
{
if (args.Context.User == null)
args.Context.User =
new System.Security.Principal.GenericPrincipal(
new System.Security.Principal.GenericIdentity("default"),
new String[0]);
}
Public Sub DefaultAuthentication_OnAuthenticate(sender As Object, _
args As DefaultAuthenticationEventArgs)
If args.Context.User Is Nothing Then
args.Context.User = _
new System.Security.Principal.GenericPrincipal( _
new System.Security.Principal.GenericIdentity("default"), _
new String(0) {})
End If
End Sub
Hinweise
Das DefaultAuthenticationModule Objekt erstellt ein DefaultAuthenticationEventArgs Objekt mithilfe des aktuellen HttpContext Objekts und übergibt es an das DefaultAuthentication_OnAuthenticate-Ereignis .
Mit der Context Eigenschaft des Objekts, das DefaultAuthenticationEventArgs dem DefaultAuthentication_OnAuthenticate-Ereignis bereitgestellt wird, können Sie die User Eigenschaft des aktuellen HttpContext Objekts auf ein benutzerdefiniertes IPrincipal Objekt festlegen. Wenn Sie keinen Wert für die User Eigenschaft angeben, auf die HttpContext von der Context Eigenschaft verwiesen wird, legt die DefaultAuthenticationModuleUser Eigenschaft des HttpContextGenericPrincipal Objekts fest, das keine Benutzerinformationen enthält.
Das DefaultAuthentication_OnAuthenticate-Ereignis wird nach dem AuthenticateRequest Ereignis und vor dem AuthorizeRequest Ereignis ausgelöst. Wenn Sie über einen authorization Abschnitt verfügen, der vom Benutzernamen abhängt, um den Zugriff auf Ihre Anwendung zu verweigern oder zuzulassen, kann das Ändern der User Eigenschaft der aktuellen HttpContext Anwendung das Verhalten Ihrer Anwendung beeinflussen. Achten Sie darauf, dass der benutzername, den Sie während des DefaultAuthentication_OnAuthenticate-Ereignisses festgelegt haben, berücksichtigt wird, wenn Sie den authorization Abschnitt in Ihrer Konfiguration angeben.
