DefaultAuthenticationEventHandler Temsilci

Tanım

Ad Alanı:

System.Web.Security

Bütünleştirilmiş Kod:

System.Web.dll

bir öğesinin DefaultAuthentication_OnAuthenticate olayını DefaultAuthenticationModuleişleyen yöntemi temsil eder.

public delegate void DefaultAuthenticationEventHandler(System::Object ^ sender, DefaultAuthenticationEventArgs ^ e);

public delegate void DefaultAuthenticationEventHandler(object sender, DefaultAuthenticationEventArgs e);

type DefaultAuthenticationEventHandler = delegate of obj * DefaultAuthenticationEventArgs -> unit

Public Delegate Sub DefaultAuthenticationEventHandler(sender As Object, e As DefaultAuthenticationEventArgs)

Parametreler

sender

Object

Olayın kaynağı.

e

DefaultAuthenticationEventArgs

DefaultAuthenticationEventArgs Olay verilerini içeren bir.

Örnekler

Aşağıdaki kod örneği, geçerli Userözelliğinin olup olmadığını HttpContext test etmek için null olayını kullanır. özelliği isenull, örnek geçerlinin User özelliğini bir HttpContext nesneye ayarlar GenericPrincipal ve burada Identity nesnenin GenericPrincipal değeri "default" olur GenericIdentityName.

Note

DefaultAuthentication_OnAuthenticate olayı, olaydan önce AuthorizeRequest oluşturulur. Sonuç olarak, geçerli User özelliğini özel bir kimliğe ayarlarsanızHttpContext, uygulamanızın davranışını etkileyebilir. Örneğin, sınıfını kullanıyorsanız FormsAuthentication ve bölümünü kullanarak authorization ve belirterek <deny users="?" />yalnızca kimliği doğrulanmış kullanıcıların sitenize erişimi olduğundan emin oluyorsanız, kullanıcının adı "varsayılan" olduğundan bu örnek öğenin yoksayılmasını sağlar deny . Bunun yerine, sitenize yalnızca kimliği doğrulanmış kullanıcıların 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

Temsilci DefaultAuthenticationEventHandler , sınıfın Authenticate olayı DefaultAuthenticationModule için tanımlanır. ASP.NET uygulamanızın Authenticate Global.asax dosyasında DefaultAuthenticationModule adlı bir alt yordam belirterek sınıfının olayına erişebilirsiniz. Olay Authenticate olaydan AuthenticateRequest sonra oluşturulur ve geçerli User özelliğinin bir HttpContext nesneyle doldurulmasını sağlamak IPrincipal için kullanılır.

DefaultAuthentication_OnAuthenticate Context sağlanan nesnenin özelliğini DefaultAuthenticationEventArgs kullanarak geçerlinin User özelliğini özel HttpContext bir nesne olarak ayarlayabilirsinizIPrincipal. User olayı sırasında sağlanan özelliği HttpContext için bir değer belirtmezseniz, DefaultAuthenticationModule öğesinin User özelliğini kullanıcı bilgisi içermeyen bir HttpContext nesneye ayarlarGenericPrincipal.

DefaultAuthentication_OnAuthenticate olayı olaydan AuthenticateRequest sonra ve olaydan önce AuthorizeRequest oluşturulur. Uygulamanıza erişimi reddetmek veya erişime izin vermek için kullanıcı adına bağlı bir authorization bölümünüz varsa, geçerli User özelliğin değiştirilmesi HttpContext uygulamanızın davranışını etkileyebilir. DefaultAuthentication_OnAuthenticate olayı sırasında ayarladığınız kullanıcı adının, yapılandırmanızda bölümü belirtirken dikkate alındığından authorization emin olun.

Uzantı Metotları

Name	Description
GetMethodInfo(Delegate)	Belirtilen temsilci tarafından temsil edilen yöntemi temsil eden bir nesnesi alır.