Services Page, Project Designer

  • Article

Client application services provide simplified access to Microsoft Ajax login, roles, and profile services from Windows Forms and Windows Presentation Foundation (WPF) applications. You can use the Services page of the Project Designer to enable and configure client application services for your project.

With client application services, you can use a centralized server to authenticate users, determine each user's assigned role or roles, and store per-user application settings that you can share across the network. For more information, see Client Application Services.

To access the Services page, select a project node in Solution Explorer, and then click Properties on the Project menu. When the Project Designer appears, click the Services tab.

Note

Client application services require the full version of the .NET Framework, and are not supported in the .NET Framework Client Profile. If the Enable client application services check box is disabled, verify that the Target framework is set to the .NET Framework 3.5 or later. To view the Target framework setting in C#, open the Project Designer and then click the Application page. To view the Target framework setting in Visual Basic, open the Project Designer, click the Compile page, and then click Advanced Compile Options.

How to: Configure Client Application Services

  • Configuration
    This control is not editable on this page. For a description of this control, see Compile Page, Project Designer (Visual Basic) or Build Page, Project Designer (C#).

  • Platform
    This control is not editable on this page. For a description of this control, see Compile Page, Project Designer (Visual Basic) or Build Page, Project Designer (C#).

  • Enable client application services
    Select to enable client application services. You must specify service locations on the Services page to use client application services.

  • Use Windows authentication
    Indicates that the authentication provider will use Windows-based authentication, that is, the identity supplied by the Windows operating system.

  • Use Forms authentication
    Indicates that the authentication provider will use forms authentication. This means that your application must provide a user interface for login. For more information, see How to: Implement User Login with Client Application Services.

  • Authentication service location
    Used only with forms authentication. Specifies the location of the authentication service.

  • Optional: Credentials provider
    Used only with forms authentication. Indicates the IClientFormsAuthenticationCredentialsProvider implementation that the authentication service will use to display a login dialog box when your application calls the static Membership.ValidateUser method and passes empty strings or null for the parameters. If you leave this box blank, you must pass a valid user name and password to the Membership.ValidateUser method. You must specify the credentials provider as an assembly-qualified type name. For more information, see Type.AssemblyQualifiedName and Assembly Names. In its simplest form, an assembly-qualified type name looks similar to the following example: MyNamespace.MyLoginClass, MyAssembly

  • Roles service location
    Specifies the location of the roles service.

  • Web settings service location
    Specifies the location of the profile (Web settings) service.

  • Advanced
    Opens the Advanced Settings for Services Dialog Box, which you can use to override default behavior. For example, you can use this dialog box to specify a database for offline storage instead of using the local file system. For more information, see Advanced Settings for Services Dialog Box.

See Also

Tasks

How to: Configure Client Application Services

Reference

Advanced Settings for Services Dialog Box

Compile Page, Project Designer (Visual Basic)

Build Page, Project Designer (C#)

Concepts

Introduction to the Project Designer

Other Resources

Client Application Services