Share via

How to: Add an Application Configuration File to a C# Project


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

By adding an application configuration file (app.config file) to a C# project, you can customize how the common language runtime locates and loads assembly files. For more information about application configuration files, see How the Runtime Locates Assemblies.


The Windows Store doesn’t support System.Configuration. As a result, Store apps don’t contain an app.config template.

When you build your project, the development environment automatically copies your app.config file, changes the file name of the copy to match your executable, and then moves the copy to the bin directory.

To add an application configuration file to your C# project

  1. On the menu bar, choose Project, Add New Item.

    The Add New Item dialog box appears.

  2. Expand Installed, expand Visual C# Items, and then choose the Application Configuration File template.

  3. In the Name text box, enter a name, and then choose the Add button.

    A file that's named app.config is added to your project.

See Also

Managing Application Settings (.NET) Configuration File Schema Configuring Apps How to: Configure an App to Target a .NET Framework Version Using the Visual Studio Development Environment for C#