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.

DefaultAuthenticationModule الفئة

Visual Studio 2010

ويضمن كائن مصادقة هو في سياق. و هذه الفئة لا يمكن أن تكون موروثة.

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

public sealed class DefaultAuthenticationModule : IHttpModule

DefaultAuthenticationModule يضمن Userخاصية الحالي HttpContextمثيل هو معينة إلى IPrincipalالكائن لكل طلب. DefaultAuthenticationModule يفحص Userخاصية بعد AuthenticateRequestحدث و قبل AuthorizeRequestحدث. إذا Userخاصية هو null، DefaultAuthenticationModuleيعين Userخاصية إلى GenericPrincipalالكائن الذي يحتوي على معلومات مستخدم لا.

يعين وحدة نمطية? لمصادقة StatusCodeخاصية إلى 401، DefaultAuthenticationModuleسوف يقدم على صفحة الخطأ "تم رفض الوصول. إذا كانت القيمة StatusCodeخاصية هو تعيين إلى قيمة أكبر من 200، DefaultAuthenticationModuleالكائن إلى إنهاء الطلب. في هذه الحالة، الوحدات النمطية HTTP فقط التي تشترك EndRequestيتم استدعاء حدث إلى قبل اكتمال الحالي طلب.

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

يستخدم المثال التالي DefaultAuthentication_OnAuthenticateحدث لاختبار ما إذا كان Userخاصية الحالي HttpContextمثيل هو null. إذا Userهو خاصية null، ثم مجموعات نموذج Userخاصية الحالي HttpContextمثيل GenericPrincipalالكائن الموقع Identityمن GenericPrincipalالكائن هو GenericIdentityمع Nameالقيمة "الافتراضي".

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

DefaultAuthentication_OnAuthenticateحدث هو raهوed قبل AuthorizeRequestحدث. كـ نتيجة، إذا قمت بتعيين Userخاصية الحالي HttpContextالمثيل إلى هوية مخصص، فإنه يمكن أن يؤثر على سلوك تطبيق الخاص بك. على سبيل المثال، إذا كنت تستخدم FormsAuthenticationالفئة وتعيين <deny users="?" />في مقطع تكوين التخويل للتأكد من أن مستخدمين المصادق عليهم فقط حق الوصول إلى الموقع الخاص بك، وترتيب هو سيؤدي نموذج رفض العنصر تجاهل، كما سيكون مستخدم اسماً، الذي هو "الافتراضي". بدلاً من ذلك، قد حددت <deny users="default" />للتأكد من المستخدمين المصادقين فقط التي يمكن الوصول إلى الموقع الخاص بك.


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]);
}


System.Object
  System.Web.Security.DefaultAuthenticationModule

يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في 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
إظهار: