This documentation is archived and is not being maintained.

User Information Sample 

Download sample

This sample provides an overview of the My.User object and the Login Form template. It implements a simple custom authentication.

Security noteSecurity Note

This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustrate the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code be used for purposes other than as intended.

To open the sample file in Solution Explorer

  1. Click Download Sample.

    The File Download message box appears.

  2. Click Open, and on the left column of the zip folder window, click Extract all files.

    The Extraction Wizard opens.

  3. Click Next. You can change the directory that the files will be extracted to, and then click Next again.

  4. Make sure that the Show extracted files check box is selected, and click Finish.

  5. Double-click the sample's .sln file.

    The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location is not trusted. Click OK to continue.

To run this sample

  • Press F5.


This sample demonstrates these tasks:

  • User name   The current Windows user's name is displayed on the main form. This value is retrieved from the My.User Object.

  • Database access   My.User allows developers to plug in their own means of custom authentication and authorization by means of the IPrincipal and IIdentity interfaces. These interfaces describe aspects of the current user that are independent of a specific authentication and authorization architecture. Implementers of the interfaces define how the user should be authenticated and what roles the user is currently enrolled in. This sample provides a very basic implementation of the IPrincipal and IIdentity interfaces to demonstrate how My.User can be configured to use developer-defined authorization and authentication mechanisms, respectively.

    Security noteSecurity Note

    The implementation in this sample does not demonstrate secure coding practices. If the user types "password" for the password, the user is authenticated.

  • Authentication mode   The behavior of the program is controlled by the authentication mode. Open the Project Designer by double-clicking the My Project node in Solution Explorer. In the Application tab, Application-defined is selected for the Authentication Mode. When you run the application, the Login form will be displayed.

See Also