This documentation is archived and is not being maintained.

How to: Manage Application Settings

In Visual Studio LightSwitch, you can manage settings that apply to the application instead of an individual screen or entity. You manage these settings in the Application Designer, which contains tabs on which you can set general, extensions, screen navigation, access control, and application type properties.

This topic covers settings on the General Properties tab. For information about settings on other tabs, see Managing Settings in LightSwitch.

NoteNote

For projects that have been upgraded to Visual Studio 2012 Update 2, some application settings appear on the Client Properties tab, which you access by choosing the Edit Client properties link on the General Properties tab.

You can manage the following settings on the General Properties tab:

Setting

Description

Application name

Specifies the name that will appear in the application’s title bar and on the Start menu. By default, the value of this setting is the project name.

Logo image

Specifies an optional image that appears on the ribbon in the default application shell. Companies typically use their corporate logos for this setting.

You can specify either a .png or .jpg image.

NoteNote

Applies only to Silverlight clients.

Shell

Specifies the application shell, which defines the layout of the application. The default value of this setting is LightSwitch Standard Shell.

You can add shells as extensions. See Extensions: Adding New Capabilities to LightSwitch.

Theme

Specifies the application theme, which defines the visual appearance of all application elements. The default value of this setting is LightSwitch Blue Theme.

NoteNote

Applies only to Silverlight clients.

You can add themes as extensions. See Extensions: Adding New Capabilities to LightSwitch.

Application icon

Specifies the icon that will appear in the Start menu and on the taskbar. If you don't specify a value, a default icon appears.

NoteNote

Applies only to Silverlight clients.

The Application icon property takes a 32X32 pixel Portable Networks Graphics (.png) file that you can create by using Paint or another graphics program. The icon is visible only for the deployed application.

Application version

Specifies a major and minor version number for the application. The default value of this setting is 1.0. The maximum version number is 65334.9999.

Culture or Default Language

Specifies a default localization culture for the LightSwitch application. The default value of this setting is the culture of the development computer.

See Walkthrough: Localizing a LightSwitch Application.

To change the application display name

  1. In Solution Explorer, open the shortcut menu for the Properties node, and then choose Open.

  2. In the Application Designer, choose the General Properties tab.

  3. For applications that have been upgraded to Visual Studio 2012 Update 2, choose the Edit Client properties link, and then choose the Client Properties tab.

  4. In the Application name field, enter the displayed new name for the application.

To change the shell

  1. In Solution Explorer, open the shortcut menu for the Properties node, and then choose Open.

  2. In the Application Designer, choose the General Properties tab.

  3. For applications that have been upgraded to Visual Studio 2012 Update 2, choose the Edit Client properties link, and then choose the Client Properties tab.

  4. In the Shell list, choose the shell that you want to apply.

To change the theme

  1. In Solution Explorer, open the shortcut menu for the Properties node, and then choose Open.

  2. In the Application Designer, choose the General Properties tab.

  3. For applications that have been upgraded to Visual Studio 2012 Update 2, choose the Edit Client properties link, and then choose the Client Properties tab.

  4. In the Theme list, choose the theme that you want to apply.

To add an application icon

  1. In Solution Explorer, open the shortcut menu for the Properties node, and then choose Open.

  2. In the Application Designer, choose the General Properties tab.

  3. For applications that have been upgraded to Visual Studio 2012 Update 2, choose the Edit Client properties link, and then choose the Client Properties tab.

  4. Choose the Select button next to the Application icon field.

  5. In the Select Image dialog box, choose the Import button.

  6. In the Open dialog box, locate the directory that contains your .png icon file, choose the icon, and then choose the Open button.

  7. Choose the OK button to close the Select Image dialog box.

    The name of the icon file appears in the Application icon field.

To change the application version

  1. In Solution Explorer, open the shortcut menu for the Properties node, and then choose Open.

  2. In the Application Designer, choose the General Properties tab.

  3. In the Application version field, enter a major version number in the first text box, and then enter a minor version number in the second text box.

    You must specify an integer between 0 and 65534.

To change the culture

  1. In Solution Explorer, open the shortcut menu for the Properties node, and then choose Open.

  2. In the Application Designer, choose the General Properties tab.

  3. In the Culture or Default Language list, choose the culture that you want to use as the default culture.

To add a logo image

  1. In Solution Explorer, open the shortcut menu for the Properties node, and then choose Open.

  2. In the Application Designer, choose the General Properties tab.

  3. For applications that have been upgraded to Visual Studio 2012 Update 2, choose the Edit Client properties link, and then choose the Client Properties tab.

  4. Choose the Select button next to the Logo image field.

  5. In the Select Image dialog box, choose the Import button.

  6. In the Open dialog box, locate the directory that contains your .png or .jpg logo, choose the file, and then choose the Open button.

  7. Choose the OK to close the Select Image dialog box.

    The name of the image file appears in the Logo image field.

Show: