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. özelliği ise, örnek geçerli HttpContext örneğin GenericPrincipal özelliğini nesnenin IdentityGenericPrincipal "default" değerine sahip olduğu bir GenericIdentityName nesne olarak ayarlarUser.nullUser

Uyarı

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ı FormsAuthentication kullanıyorsanız ve yalnızca kimliği doğrulanmış kullanıcıların sitenize erişimi olduğundan emin olmak için yetkilendirme yapılandırması bölümünde belirtirseniz<deny users="?" />, kullanıcı "varsayılan" adlı bir ada sahip 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. , DefaultAuthenticationModule olaydan sonra AuthenticateRequest ve olaydan önce AuthorizeRequest özelliğini incelerUser. 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ğinin 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 için User bu olayı kullanabilirsiniz. Olaya Authenticate , uygulamanın Global.asax dosyasında DefaultAuthentication_OnAuthenticate adlı bir olay belirtilerek erişilir.

Oluşturucular

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

Yöntemler

Name	Description
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()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
Init(HttpApplication)	Nesnesini başlatır DefaultAuthenticationModule .
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Ekinlikler

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

Ayrıca bkz.

• ASP.NET Kimlik Doğrulaması