How to: Add an application configuration file to a C# project

Applies to: yesVisual Studio noVisual Studio for Mac noVisual Studio Code

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 or about assemblies in .NET, see How the runtime locates assemblies (.NET Framework) and Assemblies in .NET.


UWP apps don't contain an app.config file.

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 a C# project

  1. In Solution Explorer, right-click the project node, and then select Add > New Item.

    The Add New Item dialog box appears.

  2. Expand Installed > Visual C# Items.

  3. In the middle pane, select the Application Configuration File template.

  4. Select the Add button.

    A file named App.config is added to your project.

See also