This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

FormsAuthenticationEventHandler مفوَّض

Visual Studio 2010

تمثل الطريقة التي يعالج FormsAuthentication_OnAuthenticateحدث من FormsAuthenticationModule.

مساحة الاسم:  System.Web.Security
التجميع:  System.Web (في System.Web.dll)

public delegate void FormsAuthenticationEventHandler(
	Object sender,
	FormsAuthenticationEventArgs e
)

المعلمات

sender
النوع: System.Object
مصدر الحدث.
e
النوع: System.Web.Security.FormsAuthenticationEventArgs
FormsAuthenticationEventArgs يحتوي على بيانات حدث.

FormsAuthenticationEventHandler تفويض هو المعرفة Authenticateحدث الخاص FormsAuthenticationModuleفئة. يمكنك الوصول إلى Authenticateحدث الخاص FormsAuthenticationModuleفئة بتعيين روتين فرعي مسمى FormsAuthentication_OnAuthenticateفي عمومي.asax ملف لتطبيق ASP.NET الخاص بك. Authenticate حدث هو raهوed أثناء AuthenticateRequestحدث.

FormsAuthenticationModule بناء FormsAuthenticationEventArgsكائن استخدام الحالي HttpContextويمرره إلى FormsAuthentication_OnAuthenticateحدث.

يمكنك استخدام Userخاصية FormsAuthenticationEventArgsكائن تزويدك FormsAuthentication_OnAuthenticateحدث لتعيين Userالخاصية الحالي HttpContextإلى مخصص IPrincipalكائن. إذا لم تعين القيمة ل Userخاصية أثناء FormsAuthentication_OnAuthenticateحدث، هوية توفره البطاقة مصادقة النماذج في ملف تعريف ارتباط أو URL هو المستخدمة.

FormsAuthentication_OnAuthenticateحدث هو raهوed فقط عند مصادقة Modeهو تعيين إلى Formsو FormsAuthenticationModuleهو الوحدة نمطية نشطة HTTP للتطبيق.

مثال التعليمة البرمجية التالية يستخدم FormsAuthentication_OnAuthenticateحدث لتعيين Userخاصية الحالي HttpContextإلى GenericPrincipalالكائن مع مخصص Identity.


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.");
  }
}


نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0, 1.1, 1.0
إظهار: