How to not copy app.config file to output directory

The handling of app.config is special, it is treated By Name, the build process will select the app.config file following this order:

  • Choose the value $(AppConfig) set in the main project.
  • Choose @(None) App.Config in the same folder as the project.
  • Choose @(Content) App.Config in the same folder as the project.
  • Choose @(None) App.Config in any subfolder in the project.
  • Choose @(Content) App.Config in any subfolder in the project.

$(AppConfig) is an MSBuild Property, if it is empty, it will look for a file with name "App.Config" in the "None" or "Content" MSBuild Item Groups, if there's a match, the file will be used and will be copied to the output directory replacing the app.config name by [AssemblyName].config

If you want to keep the file without delete it, you will need to change the "Build Action" property to something different to "None" or "Content", you can use any existing value on the list (I suggest "AdditionalFiles") or any value you want to use i.e. "MyConfigFile", and now the that will keep the file inside the project, but without the logic that generates the configuration file in the output directory.

Or you can rename the file to something different than "app.config" and keep the current property values for "Build Action" and "Copy to Output Directory".


Add /p:AllowedReferenceRelatedFileExtensions=.pdb in the MSBuild parameters to suppress library project .config files, library xml docs, etc. With the above, only PDBs are retained.

This parameter can also be added to csproj files, but personally I find it easier to manage as part of the build configuration.


After visual studio 2017 app.config is copied by default to output folder. According to MS it is by design vs developercommunity

In the MSBuild there is default property invoked called AppConfig which is equal to "app.config" However even if to set that property to empty - it will still find app config using Find task and copy: https://github.com/dotnet/msbuild/blob/13522d2466ae1634177e2a6a40fefaedff95139c/src/Tasks/Microsoft.Common.CurrentVersion.targets#L1159

The best workaround I found is to remove it manually and add back as resource:

<ItemGroup>
  <None Remove="app.config" />
  <Resource Include="app.config" CopyToOutputDirectory="Never" />
</ItemGroup>

Note that after this change app.config will not be copied at all to the output directory but will be available in Solution Explorer.