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 örneğin Userözelliğinin olup olmadığını HttpContext test etmek için null olayını kullanır. özelliği ise, örnek geçerli User örneğin null özelliğini nesnenin UserHttpContext "default" değerine sahip olduğu bir GenericPrincipalIdentity nesne olarak ayarlarGenericPrincipal.GenericIdentityName

Note

DefaultAuthentication_OnAuthenticate olayı, olaydan önce AuthorizeRequest oluşturulur. Sonuç olarak, geçerli User örneğin özelliğini özel bir kimliğe ayarlarsanızHttpContext, 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 <deny users="?" /> yapılandırması bölümünde belirtirseniz, 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 User örneğin özelliğinin her istek için bir HttpContext nesneye ayarlanmasını sağlarIPrincipal. , DefaultAuthenticationModule olaydan sonra User ve olaydan önce AuthenticateRequest özelliğini incelerAuthorizeRequest. User özelliği isenull, DefaultAuthenticationModule özelliği kullanıcı bilgisi içermeyen bir User nesneye ayarlarGenericPrincipal.

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 IPrincipal örneğin özelliği için özel User bir nesne sağlamak için HttpContext 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.

Şunlara uygulanır

Ayrıca bkz.