How to: Implement User Login with Client Application Services
You can use client application services to validate users through an existing Microsoft Ajax profile service. For information about how to set up the Microsoft Ajax profile service, see Using Forms Authentication with Microsoft Ajax.
The following procedures describe how to validate users through the authentication service when your application is configured to use one of the client authentication service providers. For more information, see How to: Configure Client Application Services.
You will typically perform all validation through the
static Membership.ValidateUser method. This method manages the interaction with the authentication service through the configured authentication provider. For more information, see Client Application Services Overview.
The forms authentication procedures require access to a running Microsoft Ajax authentication service. For guidance on end-to-end testing of client application services features, see Walkthrough: Using Client Application Services.
Implement the IClientFormsAuthenticationCredentialsProvider interface. The following code example shows a IClientFormsAuthenticationCredentialsProvider.GetCredentials implementation for a login dialog box class derived from System.Windows.Forms.Form. This dialog box has text boxes for user name and password and a "remember me" check box. When the client authentication provider calls the GetCredentials method, the form is displayed. When the user fills in the information in the login dialog box and clicks OK, the specified values are returned in a new ClientFormsAuthenticationCredentials object.
staticMembership.ValidateUser method and pass in empty strings as the parameter values. When you specify empty strings, this method internally calls the GetCredentials method for the credentials provider configured for your application. The following code example calls this method to restrict access to an entire Windows Forms application. You can add this code to a Form.Load handler.
staticMembership.ValidateUser method and pass in user name and password values retrieved from the user.
staticMembership.ValidateUser method and pass empty strings for the parameters. This method call will always return
trueand will add a cookie to the user's cookie cache that contains the Windows identity.
The example code in this topic demonstrates the simplest usages of authentication in a Windows client application. When you call the
static Membership.ValidateUser method with client application services and forms authentication, however, your code can throw a WebException. This indicates that the authentication service is unavailable. For an example of how to handle this exception, see Walkthrough: Using Client Application Services.
Client Application Services
Client Application Services Overview
How to: Configure Client Application Services
Walkthrough: Using Client Application Services
Using Forms Authentication with Microsoft Ajax