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.

FormsAuthenticationModule الفئة

Visual Studio 2010

قم بتعيين هوية مستخدم لتطبيق ASP.NET عندما تشكل المصادقة هو ممكنة. و هذه الفئة لا يمكن أن تكون موروثة.

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

public sealed class FormsAuthenticationModule : IHttpModule

FormsAuthenticationModule يعين الحالي HttpContext.Userخاصية إلى IPrincipalطلب كائن يمثل هوية مستخدم للحالي عند مصادقة Modeهو تعيين إلى Formsفي مصادقة عنصر (مخطط إعدادات ASP.NET)عنصر في ملف تكوين للتطبيق.

FormsAuthenticationModule الكشف عن Authenticateالحدث الذي يتيح لك إلى توفير cusإلىm IPrincipalالكائن Userخاصية الحالي HttpContext. Authenticate حدث هو الوصول إليها عن طريق تحديد روتين فرعي مسمى FormsAuthentication_OnAuthenticateفي الملف عمومي.asax لتطبيق ASP.NET.

ملاحظةملاحظة

في IIS 7.0، استخدام WindowsAuthenticationModuleمع FormsAuthenticationModuleغير معتمد. لمزيد من معلومات حول موضوعات توافق في أوضاع المتكاملة، راجع نقل تطبيق ASP.NET من IIS 6.0 إلى IIS 7.0.

يستخدم المثال التالي FormsAuthentication_OnAuthenticateحدث لتعيين Userخاصية الحالي HttpContextإلى مخصص IPrincipalالكائن.


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


System.Object
  System.Web.Security.FormsAuthenticationModule

يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل 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
إظهار: