Drop the ManageCards control onto a web page to let your membership users associate Information Cards with their Asp.Net Membership Account.
Once they've done so, they can use their Identity card to log into your web site.
The ManageCards Control
The control presents a title, instructions, a CardSpace button and a GridView listing
the cards that are currently associated
with the current user's Asp.Net membership
account. The user can click the button to associate additional cards (allowing
them to log in from different computers.)
Rich design-time experience
If you've used the Asp.Net CreateUserWizard or Login Controls, you'll be instantly familiar with the ManageCards Control. It provides the same Auto-Format options (Elegant, Professional,
Simple, Classic, etc.) and is fully templated. This means that you have complete
control over the layout and style.
Events
In addition to base control events, the ManageCards Control raises the following
events as it works through the process of receiving the card and adding/deleting
the record.
-
ClaimsPresented - Provides a claims object
-
ClaimsPresentedError - Provides the claims object plus the exception
- AddingCard - Provides the membership user object, claims object plus a chance to cancel
- AddedCard- Provides the membership user object and the claims object
- AddingCardError - Provides the membership user object, the claims object and the
exception
- DeletingCard - Provides claims, membership user and a chance to cancel
- DeletedCard- Provides the claims and membership user objects
- DeletingCardError - Provides the membership user object, claims object plus the exception
Database
The ManageCards Control uses following stored procedures:
- aspnetEx_InformationCards_FindCardsByUserID
- aspnetEx_InformationCards_DeleteCardForUserID
- aspnetEx_InformationCards_CreateCardForUserID
As
mentioned in the
CardSpace Control Database Elements topic,
the required database table and stored procedures are created automatically if possible.
About the CardSpace Button
The ManageCards Control includes the CardSpace Button as one of its constituent
controls. Since the button is itself an input control that contains HTML markup
(an embedded table, the image and the prompt text), Asp.Net will display the warning
"
A potentially dangerous Request.Form value was detected from the client".
This is the default behavior to prevent potential script/sql injection attacks.
Assuming you've taken basic defensive measures, you can safely disable this behavior
by setting "ValidateRequest = false" in the page declaration (first line in source
view) of your web page.
Setting ValidateRequest = "False"
Support
If you need help getting the ManageCards Control to work on your web site, please visit our
Support Forum.
The complete API for the CardSpace Controls is available
here.