Login Control

Author: aspnet100@yahoo.com LoginControl Revision History: ______________________ V.1.2.2.1 - 09-28-2003 *New: 1.Login (and Password) label can be in a separate row from the input text box. 2.Login Confirmation is available by option. 3.Add ValidatorStyle for LoginID and Password validators. 4.Can call a javascript function when Login control loads. 5.Allow non-named colors (e.g. #eeffdd) in BackColor and BorderColor. *Change: 1.DLL name changed to Mars.Controls.LoginControl.dll. 2.Change default label font to Verdana. 3.Login and Register Buttons aligned to the left. 4.No more built on .NET Framework V.1.0.3705. 5.New Taget at .NET Framework V.1.1.4322. ---------------------- ______________________ V.1.1.0.0 - 04-27-2003 *New: Added a "Remember Password" check box. *Change: Improved user experience: the control will now display instantly when it's dropped on the Web form, no need to first select the Button Type in the Property window. *Change: DLL name changed to JoeWoods.LoginControl.dll from JoeWoods.ServerControls.dll. ---------------------- ______________________ V.1.0.0.0 - 04-21-2003 Initial Version ---------------------- ___________________________________ Target: .NET Framework V.1.1.4322 ----------------------------------- **V.1.2.2.1 Note** The following Description and Installation have been edited specifically for LoginControl - V.1.2.2.1, for general information, the Note in the previous release still applies. 1. There is one new DLL in the zipped file: Mars.ConfirmedButtons.dll, please copy it into the /bin folder. This DLL provides the optional login confirmation set by LoginConfirmedRequired attribute. 2. Supports client JS function when control loads, which is very useful if you need to call client side function e.g. preloading images for dynamic visible affect. 3. In the JS function, do not use 'alert' to pop up a message. Otherwise, it will hide the client side validation. 4. If you change LoginConfirmationRequired in the Desginer, you might need to (save and) reopen the page to have it take effect. 5. The enclosed example shows you some new functionality in this new version. There is more, please explore youself and have fun. 6. To run the new sample page: enter /localhost/<vir-dir>/admin/loginControlTest1221.aspx, if you have followed the installatiion procedure below. **V.1.1.0.0 Note** The following Description and Installation have been edited for LoginControl - V.1.1.0.0. Description: LoginControl is a custom server control which provides the Form user authentication graphic interface for a secure Web site. It is completely design time configurable, contains the following child controls: 1. LoginID Label, 2. LoginID Textbox, 3. LoginIDRequiredFieldValidator, 4. Password Label, 5 Password Textbox, 6. PasswordRequiredFieldValidator, 7. Login Textbutton, 8. Login Linkbutton, 9. Register Textbutton, 10. Register Linkbutton. 11. "Remember Password" Label, 12. "Remember Password" CheckBox. and exposes the following properties to programmatically access the user input: 1. LoginID (string), 2. Password (string), 3. IsRememberPassword (bool). Login button is mandatory, Register button and Remeber checkbox are optional. All child controls can be visually designed in the IDE such as VS.NET. This includes label captions, validator messages, the size and maxLength of textboxes, style of the label, textbox, text button, link buttons, font name, colors, etc. There are two types of action buttons to choose for Login and Register: Text button and Link button. The control users (or the Page developers) must provide an event handler for Logon event so the form's Postback can authenticate the user input credential. An optional Register button can be displayed for redirecting a new user to a Registration form. The optional "Remember Password" can be used to set permanent authentication cookies if users choose to do so. The Registration form must be an ASPX page (even it is an HTML form), and its URL should be specified using relative path if it is in a different folder(e.g. ../reg/Registration.aspx ). One nice feature of the control is it automatically sets initial focus on the LoginID textbox when the page loads. It is assumed that the control is used in the first form of the page. This is true as long as the Framework does not support more than one form as it currently. The control provides three accessors: LoginID, Password, and IsRememberPassword of user input, which you would need to use for programmatic authentication. NOTE: The control has been built and tested in .NET Framework V1.0.3705. The zipped file includes one DLL of the control itself, and several sample ASPX files, in two folders, to demostrate how the control being used. Please follow the instructions below to install the control and see how the sample works. Installation: 1. Unzip the loginControl.zip file and extract it to a temp folder. 2. Create a virtual directory or use an existing one, copy both Mars.Controls.LoginControl.dll and Mars.ConfirmedButtons.dll to its /bin folder. 3. Copy the other two folders (/admin and /reg) under this virtual directory. 4. In the IE browser, enter /localhost/<vir-dir>/admin/loginControlTest11.aspx to see the text button version of the working Login control. 5. Enter /localhost/<vir-dir>/admin/loginControlTestL11.aspx to see the link button version of the slightly different design. 6. You can click the Register button to view a Registration form. 7. To use LoginControl in your own project, do the following: 8. In your ASP.NET Web project, right-click on References folder, select "Add Reference...", "Browse..." to add JoeWoods.LoginControl.dll to the project, this will copy the control dll in the project's /bin folder. 9. Next, bring up your Toolbox pane by clicking the View menu, select "Toolbox", select "Web Forms" tab. Right-click anywhere in the pane and select "Customize Toolbox...", click ".Net Framework" tab, browse and locate JoeWoods.LoginControl.dll as you did in step 1. This will create the LoginControl icon in the Toolbox that you can drag and drop in the Designer. (Sorry that I could not get a designated icon next to the control. I tried to embed it without shipping the separated bitmap file but no luck. Show me if you have a sample project to do so). 10. Now you are ready to use the control in your Web form. Just drag the LoginControl icon in the ToolBox pane and drop it to the Web form. The control should appear in the form with all its child controls. By manipulating the Property window, you can design the control to fit your need. If you do not want to show the optional Register button or Remeber check box, simply change the RegisterButtonText or RememberPasswordText to empty string. 11. Do not forget to provide an event handler for the Logon so the Postback can handle the user authentication properly. 12. All rights reserved to the control author - aspnet100@yahoo.com. By using the control you accept the disclaimer below: 13. THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.