Welcome Sign in
Windows Live Developer Center
Printer Friendly Version      Send     
Click to Rate and Give Feedback
MSDN
MSDN Library
Web Development
Windows Live
 IDLoginView Control
Windows Live
IDLoginView Control

This topic describes the parameters and default values created when you add the IDLoginView control to enable Windows Live™ ID authentication, including support for associating a Windows Live ID with an ASP.NET membership profile, on a Web page.

<live:IDLoginView 
      ID="id" > 
</live:IDLoginView>

The parameters shown in the syntax section and in the beginning of the parameters table are the parameters created when dragging the control from the Toolbox and dropping it on a Web page. The default values in the description are also those created when dragging the control from the Toolbox and dropping it on a Web page.

Parameter Description

ID

Required. The unique identifier for the control on the Web page. The default value is IDLoginView1.

AutomaticallyAssociateAuthentication

Optional. A Boolean value specifying whether to prompt users to associate their Windows Live ID with an ASP.NET membership profile. The Web application should provide a mechanism so users can be authenticated in both these authentication mechanisms before setting this to true.

PromptOnAssociation

Optional. A Boolean value specifying whether the Contol displays the AssociationTemplate, so users can associate the Windows Live ID with their ASP.NET profile on the Web site. If this parameter is set to false, the control automatically performs the association.

The IDLoginView control extends the functionality of the ASP.NET LoginView control by adding support for Windows Live ID authentication. In addition, this control provides Web applications with a mechanism to associate a Windows Live ID with an ASP.NET membership profile. This enables users to log onto a Web site using a single sign-on experience.

The control includes templates to display different information to anonymous and logged-in users with ASP.NET membership profiles, Windows Live ID, or both.

This control can display different information to anonymous and logged-in users with ASP.NET membership profiles, Windows Live ID, or both. A template can contain markup information and can display information that is appropriate for anonymous or authenticated users (either ASP.NET membership, Windows Live ID, or both).

Template Description

AnonymousTemplate

The template to display to users not logged into the Web site.

AssociatePromptTemplate

The template to display to users who have not associated their ASP.NET membership profile with their Windows Live ID.

LoggedInAllTemplate

The template to display to users logged in with both an ASP.NET membership profile and Windows Live ID.

LoggedInIDTemplate

The template to display to users logged in with Windows Live ID.

LoggedInTemplate

The template to display to users logged in with an ASP.NET membership profile.

RoleGroups

The template to display to users logged in with an ASP.NET membership role.

The IDLoginView control can raise the following server events.

Event Description

OnViewChanged

Raised after the template is changed.

OnViewChanging

Raised before the template change occurs on the page.

OnViewChanged Event

A server event that is raised the template is changed.

C# Syntax

using Microsoft.Live.ServerControls;
…
protected void OnViewChangedHandler(object sender, EventArgs e)

Parameters

Parameter Description

sender

The IDLoginView object.

e

The EventArgs object.

OnViewChanging Event

A server event that is raised before the template change occurs on the page.

C# Syntax

using Microsoft.Live.ServerControls;
…
protected void OnViewChangingHandler(object sender, EventArgs e)

Parameters

Parameter Description

sender

The IDLoginView object.

e

The EventArgs object.
© 2008 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker