Advanced Settings for Services Dialog Box

Note

This article applies to Visual Studio 2015. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

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 in the Project Designer to configure client application services. For more information about the Services page, see Services Page, Project Designer.

Use the Advanced Settings for Services dialog box of the Services page in the Project Designer to configure advanced settings for client application services. By using these settings, you can override some default application service behaviors to enable less common scenarios. For more information, see Client Application Services.

To access the Advanced Settings for Services dialog box, select a project node in Solution Explorer, and then click Properties on the Project menu. When the Project Designer appears, click the Services tab, and then click the Advanced button. This button will be disabled until you enable client application services.

Task List

How to: Configure Client Application Services

How to: Work Offline with Client Application Services

UIElement List

Save password hash locally to enable offline login Specifies whether an encrypted form of the user's password will be cached locally to enable the user to log in when the application is in offline mode. For more information, see How to: Work Offline with Client Application Services. This option is selected by default.

Require users to log on again whenever the server cookie expires Specifies whether previously authenticated users are automatically reauthenticated when your application accesses the roles or profile service and the server authentication cookie has expired. Select this option to deny access to the application services and require explicit reauthentication after the cookie expires. This is useful for applications deployed in public locations to make sure that users who leave the application running after use will not remain authenticated indefinitely. This option is cleared by default.

Role service cache timeout Specifies the amount of time the client role provider will use cached role values instead of accessing the roles service. Set this time interval to a small value when roles are updated frequently or to a larger value when roles are updated infrequently. The default value is one day.

The role provider accesses the cached role values or the roles service when you call the IsInRole method. To programmatically clear the cache and force this method to access the remote service, call the ResetCache method.

Use custom connection string Specifies whether the client service providers will use a custom data store for the local cache. By default, the service providers will use the local file system for the cache. Selecting this option will automatically populate the text box with a default connection string. You can keep the default connection string to automatically generate and use a SQL Server Compact Edition database, or you can specify a connection string to an existing SQL Server database. For more information, see How to: Configure Client Application Services. This option is cleared by default.

See Also

Client Application Services Services Page, Project Designer How to: Configure Client Application Services How to: Work Offline with Client Application Services