200

How is

<None Include="C:\foo.bar" />

different from

<Content Include="C:\foo.bar" />

?

2
  • 7
    I had a few Contents get changed to Nones. I think it happened when I renamed files from .ascx to .cshtml when converting to Razor. Changing them back manually fixed some deployment issues I had. Glad I found this. Feb 24, 2011 at 18:13
  • Because None and Content are Common MSBuild project items, the Item metadata names together with Include="foo.bar" apply to VS project files of other languages as well. Jan 5 at 5:34

8 Answers 8

179

The MSDN article on the build action property explains the differences.

None - The file is not included in the project output group and is not compiled in the build process. An example is a text file that contains documentation, such as a Readme file.

Content - The file is not compiled, but is included in the Content output group. For example, this setting is the default value for an .htm or other kind of Web file.

7
  • 8
    Thanks, I had trouble locating this reference.
    – Emmett
    Jun 29, 2009 at 22:26
  • Helpful, but why have a "None" item at all, if the file is not to be included in the output? What's the point?
    – JimH44
    Apr 23, 2018 at 9:03
  • 1
    @JimH44 <None> items are often used to specifically copy files into the output directory, even though they're not in the output group by default. If you select "Copy to Output Directory" -> "Copy Always" for a <None> file, this will cause it to be copied, and you will see the entry added to the project's .csproj file will have a <None> entry for the file. Feb 26, 2019 at 16:39
  • 14
    So then what is difference between a <None> file with "Copy to Output Directory" -> "Copy Always" and a <Content> file with "Copy to Output Directory" -> "Copy Always"?
    – hashtable
    Mar 25, 2020 at 1:57
  • @JimH44 I have some SQL files that I execute in a post-deployment process. Don't need them to be part of the build, nor to be included in the output. I believe there are plenty of such use-cases for this approach.
    – dvlsc
    Dec 18, 2020 at 9:30
33

One difference is how they get published; "None" items don't get included in a publish, "Content" items do; for example, on the "Application Files" dialog on the Publish tab.

2
  • 19
    Not true. At least in the new dot net cli. if you have an item declared as None with a CopyToOutputDirectory set to true it will get published in a dotnet publish
    – disklosr
    Jan 3, 2019 at 10:14
  • Not sure either about PublishState with Excluded description. Jan 5 at 15:09
15

I am not 100% sure (I read the MSDN description of Build Action property) but just copying that answer from MSDN to StackOverflow does not answer the question completely for me.

The difference of None and Content only has an effect on Web projects. For a command line project, WinForm project or UnitTest project (in my case) etc. None and Content have no different behavior.

MSDN: "project output group" or "Content output group" only terms used in a Web project, right?

1
  • 2
    Like you say, seems None vs Content only has effect for the publish step not the build step. For the build step seems CopyToOutputDirectory can be set on either and that controls if the file is copied by the build step. Also seems odd that by default T4 templates are added as Content items and not None items. Oct 2, 2016 at 22:14
11

In my situation, my MSBuild file had an ItemGroup for image resources that appeared as follows:

  <ItemGroup>
    <Content Include="Resources\image001.png" />
    <Content Include="Resources\image002.png" />
    <Content Include="Resources\image003.png" />
    <Content Include="Resources\image004.png" />
    <None Include="Resources\image005.png" />
    <None Include="Resources\image006.png" />
    <None Include="Resources\image007.png" />
  </ItemGroup>

While my project was building fine, this left me wondering why I had a mix of Content and None item type elements in my ItemGroup. This MSDN article (for Visual Studio 2010) gave me the guidance I was looking for:

Note that when the resource editor adds an image, it sets Build Action to None, because the .resx file references the image file. At build time, the image is pulled into the .resources file created out of the .resx file. The image can then easily be accessed by way of the strongly-typed class auto-generated for the .resx file. Therefore, you should not change this setting to Embedded Resource, because doing this would include the image two times in the assembly.

Resolution: With this guidance, using a text editor, I changed the Content item type elements to None.

Also, for an overview of MSBuild items, see this MSDN article.

6

Content files are not included in a build, but are included in a publish.

None files are not included in a build or publish, unless they are configured that way by you. For instance, a "Copy to Output Directory" setting of "Always" or "Newer", will cause them to be included in both a build and publish.

3

I have a project that contains no compilable items (it stores html and javascript for jasmine unit tests).

One day my solution (that contained said project) stopped compiling saying "The target "Build" does not exist in the project".

I added an import to bring in the compiler, which worked fine on my machine but failed using msbuild on the build server.

<Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />

I then changed a line from

<None Include="SpecRunner.html" />

to

<Content Include="SpecRunner.html" />

and it worked on the build server as well.

2

You need None in a template project file to include files you define in the .vstemplate otherwise they are lost in the creation & translation process. They get left behind in the temp folder it uses to build everything and then deleted shortly after.

2

In my case .Pubxml is one of those files among None list. It's not meant for solution building or as a static file for web project. But to publish the site to Azure, the configurations are present in this.

As per Microsoft article these are the major types we see among .csproj file tags:

None - The file is not included in the project output group and is not compiled in the build process. An example is a text file that contains documentation, such as a Readme file.

Compile - The file is compiled into the build output. This setting is used for code files.

Content - The file is not compiled, but is included in the Content output group. For example, this setting is the default value for an .htm or other kind of Web file.

Embedded Resource - This file is embedded in the main project build output as a DLL or executable. It is typically used for resource files.

3
  • 1
    Please comment here, if something is misleading or not clear, Just a down vote doesn't help me improve it any better. Thanks in advance.
    – IKriKan
    Jan 7, 2019 at 4:34
  • 1
    I often got error: "None" element name for include "Properties\PublishProfiles\FolderProfile.pubxml" should be "Content". in my Asp.Net project on Bamboo, and sometime rerun the build can just fix it, so don't know what exactly the problem is
    – Bochen Lin
    Jun 9, 2020 at 7:02
  • Hi @BochenLin, the details you mentioned here are bit scanty, can you try to give more details here or post a new question with complete issue details and screenshot if possible [and then share the question link here] .
    – IKriKan
    Jun 9, 2020 at 11:01

Your Answer

Reminder: Answers generated by Artificial Intelligence tools are not allowed on Stack Overflow. Learn more

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.