DefaultAuthenticationModule Sınıf

Tanım

Ad Alanı:

System.Web.Security

Bütünleştirilmiş Kod:

System.Web.dll

Bir kimlik doğrulama nesnesinin bağlamda mevcut olmasını sağlar. Bu sınıf devralınamaz.

public ref class DefaultAuthenticationModule sealed : System::Web::IHttpModule

public sealed class DefaultAuthenticationModule : System.Web.IHttpModule

type DefaultAuthenticationModule = class
    interface IHttpModule

Public NotInheritable Class DefaultAuthenticationModule
Implements IHttpModule

Devralma

Object

DefaultAuthenticationModule

Uygulamalar

IHttpModule

Örnekler

Aşağıdaki örnek, geçerli HttpContext örneğin nullözelliğinin olup olmadığını User test etmek için DefaultAuthentication_OnAuthenticate olayını kullanır. User özelliği isenull, örnek geçerli HttpContext örneğin GenericPrincipal özelliğini nesnesinin değeri "default" olan IdentityGenericPrincipal bir GenericIdentityName nesne olarak ayarlarUser.

Not

DefaultAuthentication_OnAuthenticate olayı olaydan önce AuthorizeRequest oluşturulur. Sonuç olarak, geçerli HttpContext örneğin özelliğini özel bir kimliğe ayarlarsanızUser, uygulamanızın davranışını etkileyebilir. Örneğin, sınıfını kullanıyorsanız FormsAuthentication ve yalnızca kimliği doğrulanmış kullanıcıların sitenize erişebildiğinden emin olmak için yetkilendirme yapılandırması bölümünde belirtirseniz<deny users="?" />, kullanıcının adı "varsayılan" olacağı için bu örnek reddetme öğesinin yoksayılmasını sağlar. Bunun yerine, yalnızca kimliği doğrulanmış kullanıcıların sitenize erişebildiğinden emin olmak için belirtmeniz gerekir<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]);
}

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

Açıklamalar

, DefaultAuthenticationModule geçerli HttpContext örneğin özelliğinin her istek için bir IPrincipal nesneye ayarlanmasını sağlarUser. özelliği DefaultAuthenticationModule olaydan User sonra AuthenticateRequest ve olaydan önce AuthorizeRequest inceler. User özelliği isenull, DefaultAuthenticationModule özelliği kullanıcı bilgisi içermeyen bir GenericPrincipal nesneye ayarlarUser.

Kimlik doğrulama modülü özelliği 401 olarak ayarlarsa StatusCode , DefaultAuthenticationModule erişim reddedildi hata sayfasını işler. Özelliğin StatusCode değeri 200'den büyük bir değere ayarlanırsa, DefaultAuthenticationModule nesne isteği sona erdirecektir. Bu durumda, geçerli istek tamamlanmadan önce yalnızca olaya abone EndRequest olan HTTP modülleri çağrılır.

bir DefaultAuthenticationModuleAuthenticate olayı kullanıma sunar. Geçerli HttpContext örneğin özelliği için özel IPrincipal bir nesne sağlamak üzere User bu olayı kullanabilirsiniz. Olaya Authenticate , uygulamanın Global.asax dosyasında DefaultAuthentication_OnAuthenticate adlı bir olay belirtilerek erişilir.

Oluşturucular

DefaultAuthenticationModule()

DefaultAuthenticationModule sınıfının yeni bir örneğini başlatır.

Yöntemler

Dispose()	tarafından DefaultAuthenticationModulekullanılan bellek dışındaki tüm kaynakları serbest bırakır.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
Init(HttpApplication)	DefaultAuthenticationModule Nesnesini başlatır.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ekinlikler

Authenticate

İsteğin kimliği doğrulandıktan sonra gerçekleşir.

Ayrıca bkz.

• ASP.NET Kimlik Doğrulaması