Login::Authenticate Event

.NET Framework (current version)

Occurs when a user is authenticated.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)

Syntax

public:
event AuthenticateEventHandler^ Authenticate {
	void add(AuthenticateEventHandler^ value);
	void remove(AuthenticateEventHandler^ value);
}

Remarks

The Authenticate event is raised when a user uses the Login control to log in to a Web site. Custom authentication schemes can use the Authenticate event to authenticate users.

Note
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. 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.

Notes to Implementers:

Custom authentication schemes should set the Authenticated property to true to indicate that a user has been authenticated.

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.

Examples

The following code example uses the Authenticate event to call site-specific custom authentication code.

C++

No code example is currently available or this language may not be supported.

Version Information

.NET Framework
Available since 2.0