The IDLoginStatus control can raise both server and client events. Server events occur before client events and are handled in server-side code that you write for the Web page. Client events are handled in client script, typically ECMAScript (JavaScript), and are raised after server events. The server-side events are triggered even if client-side events are not present.
|
Event
|
Designation: Server or Client
|
Description
|
| OnClientSignIn | Client | Raised when the user signs in. |
| OnClientSignOut | Client | Raised when the user signs out. |
| OnServerSignIn | Server | Raised when the user signs in. |
| OnServerSignOut | Server | Raised when the user signs out. |
OnClientSignIn Event
A client event that is raised when the user signs in.
JavaScript Syntax
|
function OnClientSignInHandler(sender, args) |
Parameters
|
Parameter
|
Description
|
| sender | The DOM element raising the event. |
| args | The event arguments object. This object has the methods get_cancel and set_cancel. |
Remarks
Use the set_cancel method to cancel the execution of the associated server event.
OnClientSignOut Event
A client event that is raised when the user signs out.
JavaScript Syntax
|
function OnClientSignoutHandler(sender, args) |
Parameters
|
Parameter
|
Description
|
| sender | The DOM element raising the event. |
| args | The event arguments object. This object has the methods get_cancel and set_cancel. |
Remarks
Use the set_cancel method to cancel the execution of the associated server event.
OnServerSignIn Event
A server event that is raised when the user signs in.
C# Syntax
|
using Microsoft.Live.ServerControls;
…
protected void OnServerSignInHandler(object sender, AuthEventArgs e) |
Parameters
|
Parameter
|
Description
|
| sender | The IDLoginStatus object. |
| e | The AuthEventArgs object. It has the following members, which help identify the user who signed in: Action ApplicationContext ApplicationUserID TimeStamp |
OnServerSignOut Event
A server event that is raised when the user signs out.
C# Syntax
|
using Microsoft.Live.ServerControls;
…
protected void OnServerSignOutHandler(object sender, AuthEventArgs e) |
Parameters
|
Parameter
|
Description
|
| sender | The IDLoginStatus object. |
| e | The AuthEventArgs object. The AuthEventArgs class is derived from the EventArgs class and has the following members, which are accessible during server-side event handling to help identify the user who signed out: Action ApplicationContext ApplicationUserID TimeStamp |