En un archivo .csproj, ¿para qué sirve <None Include = "...">?

Como es

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

diferente de

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

?

El artículo de MSDN sobre la propiedad de acción de compilación explica las diferencias.

Ninguno : el archivo no se incluye en el grupo de salida del proyecto y no se compila en el proceso de compilación. Un ejemplo es un archivo de texto que contiene documentación, como un archivo Léame.

Contenido : el archivo no se compila, pero se incluye en el grupo de salida Contenido. Por ejemplo, esta configuración es el valor predeterminado para un .htm u otro tipo de archivo web.

Una diferencia es cómo se publican; Los elementos "Ninguno" no se incluyen en una publicación, los elementos "Contenido" sí; por ejemplo, en el cuadro de diálogo "Archivos de aplicación" en la pestaña Publicar.

No estoy 100% seguro (leí la descripción de MSDN de la propiedad Build Action ), pero solo copiar esa respuesta de MSDN a StackOverflow no me responde la pregunta por completo.

La diferencia de Ninguno y Contenido solo tiene un efecto en los proyectos web. Para un proyecto de línea de comando, proyecto WinForm o proyecto UnitTest (en mi caso), etc. Ninguno y el Contenido no tienen un comportamiento diferente.

MSDN: "grupo de salida de proyecto" o "grupo de salida de contenido" solo términos utilizados en un proyecto web, ¿verdad?

En mi situación, mi archivo MSBuild tenía ItemGrouprecursos de imagen que aparecían de la siguiente manera:

  <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>

Si bien mi proyecto fue la construcción de bien, este me dejó preguntándose por qué tenía una mezcla de Contenty Noneelementos de tipo de elemento en mi ItemGroup. Este artículo de MSDN (para Visual Studio 2010) me dio la orientación que estaba buscando:

Tenga en cuenta que cuando el editor de recursos agrega una imagen, establece la Acción de compilación en Ninguna , porque el archivo .resx hace referencia al archivo de imagen. En el momento de la compilación, la imagen se extrae en el archivo .resources creado a partir del archivo .resx. Se puede acceder fácilmente a la imagen a través de la clase fuertemente tipada autogenerada para el archivo .resx. Por lo tanto, no debe cambiar esta configuración a Recursos integrados , ya que esto incluiría la imagen dos veces en el ensamblaje.

Resolución: con esta guía, utilizando un editor de texto, cambié los Contentelementos de tipo de elemento a None.

Además, para obtener una descripción general de los elementos de MSBuild, consulte este artículo de MSDN .

Tengo un proyecto que no contiene elementos compilables (almacena html y javascript para pruebas unitarias de jazmín).

Un día, mi solución (que contenía dicho proyecto) dejó de compilarse diciendo "El objetivo" Compilar "no existe en el proyecto".

Agregué una importación para traer el compilador, que funcionó bien en mi máquina pero falló al usar msbuild en el servidor de compilación.

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

Luego cambié una línea de

<None Include="SpecRunner.html" />

a

<Content Include="SpecRunner.html" />

y funcionó en el servidor de compilación también.

No necesita Ninguno en un archivo de proyecto de plantilla para incluir los archivos que defina en .vstemplate; de ​​lo contrario, se perderán en el proceso de creación y traducción. Se quedan atrás en la carpeta temporal que usa para construir todo y luego se eliminan poco después.

En mi caso .Pubxml es uno de esos archivos de la lista Ninguno . No está destinado a la creación de soluciones o como un archivo estático para proyectos web. Pero para publicar el sitio en Azure, las configuraciones están presentes en esto.

Según el artículo de Microsoft, estos son los tipos principales que vemos entre las etiquetas de archivo .csproj :

Ninguno: el archivo no se incluye en el grupo de salida del proyecto y no se compila en el proceso de compilación. Un ejemplo es un archivo de texto que contiene documentación, como un archivo Léame.

Compilar: el archivo se compila en la salida de compilación. Esta configuración se usa para archivos de código.

Contenido: el archivo no se compila, pero se incluye en el grupo de salida Contenido. Por ejemplo, esta configuración es el valor predeterminado para un .htm u otro tipo de archivo web.

Recurso incrustado: este archivo se incrusta en la salida de compilación del proyecto principal como un archivo DLL o ejecutable. Por lo general, se usa para archivos de recursos.

Los archivos de contenido no se incluyen en una compilación, pero se incluyen en una publicación.

Ninguno de los archivos no se incluye en una compilación o publicación, a menos que usted los configure de esa manera. Por ejemplo, una configuración de "Copiar al directorio de salida" de "Siempre" o "Más reciente" hará que se incluyan tanto en una compilación como en una publicación.