验证用户的身份后出现。Occurs when a user is authenticated.

public:

event System::Web::UI::WebControls::AuthenticateEventHandler ^ Authenticate;

public event System.Web.UI.WebControls.AuthenticateEventHandler Authenticate;

member this.Authenticate : System.Web.UI.WebControls.AuthenticateEventHandler

Public Custom Event Authenticate As AuthenticateEventHandler

事件类型

示例

下面的代码示例使用 Authenticate 事件来调用特定于站点的自定义身份验证代码。The following code example uses the Authenticate event to call site-specific custom authentication code.

private bool SiteSpecificAuthenticationMethod(string UserName, string Password)

{

// Insert code that implements a site-specific custom

// authentication method here.

//

// This example implementation always returns false.

return false;

}

private void OnAuthenticate(object sender, AuthenticateEventArgs e)

{

bool Authenticated = false;

Authenticated = SiteSpecificAuthenticationMethod(Login1.UserName, Login1.Password);

e.Authenticated = Authenticated;

}

ASP.NET Example

OnAuthenticate="OnAuthenticate">

Function SiteSpecificAuthenticationMethod(ByVal UserName As String, ByVal Password As String) As Boolean

' Insert code that implements a site-specific custom

' authentication method here.

'

' This example implementation always returns false.

Return False

End Function

Sub OnAuthenticate(ByVal sender As Object, ByVal e As AuthenticateEventArgs)

Dim Authenticated As Boolean

Authenticated = SiteSpecificAuthenticationMethod(Login1.UserName, Login1.Password)

e.Authenticated = Authenticated

End Sub

ASP.NET Example

OnAuthenticate="OnAuthenticate">

注解

Authenticate当用户使用 Login 控件登录到网站时，将引发事件。The Authenticate event is raised when a user uses the Login control to log in to a Web site. 自定义身份验证方案可以使用 Authenticate 事件对用户进行身份验证。Custom authentication schemes can use the Authenticate event to authenticate users.

备注

当用户使用 Login 控件登录到网站时，视图状态和所有 post 数据中的所有数据都将丢失。When a user uses the Login control to log in to a Web site, all data in the view state and all post data is lost. 不要在依赖于视图状态的事件中执行操作 Authenticate 。Do not perform actions in the Authenticate event that rely on the view state.

有关处理事件的详细信息，请参阅 处理和引发事件。For more information about handling events, see Handling and Raising Events.

继承者说明

自定义身份验证方案应将 Authenticated 属性设置为，以指示已对 true 用户进行身份验证。Custom authentication schemes should set the Authenticated property to true to indicate that a user has been authenticated.

当用户提交其登录信息时， Login 控件首先引发 LoggingIn 事件，然后引发事件 Authenticate ，最后引发 LoggedIn 事件。When a user submits his or her login information, the Login control first raises the LoggingIn event, then the Authenticate event, and finally the LoggedIn event.

适用于

另请参阅