Share via

FileClassifier task

  • Article

The FileClassifier task classifies a set of source resources as those that will be embedded into an assembly. If a resource is not localizable, it is embedded into the main application assembly; otherwise, it is embedded into a satellite assembly.

Task parameters

Parameter Description
CLREmbeddedResource Unused.
CLRResourceFiles Unused.
CLRSatelliteEmbeddedResource Unused.
Culture Optional String parameter.

Specifies the culture for the build. This value can be null if the build is non-localizable. If null, the default value is the lowercase value that CultureInfo.InvariantCulture returns.
MainEmbeddedFiles Optional ITaskItem[] output parameter.

Specifies the non-localizable resources that are embedded into the main assembly.
OutputType Required String parameter.

Specifies the type of file to embed the specified source files into. The valid values are exe, winexe, or library.
SatelliteEmbeddedFiles Optional ITaskItem[] output parameter.

Specifies the localizable files that are embedded into the satellite assembly for the culture specified by the Culture parameter.
SourceFiles Required ITaskItem[] parameter.

Specifies the list of files to classify.

Remarks

If the Culture parameter is not set, all resources that are specified by using the SourceFiles parameter are non-localizable; otherwise, they are localizable, unless they are associated with a Localizable attribute that is set to false.

Example

The following example classifies a single source file as a resource and then embeds it in a satellite assembly for the French-Canadian (fr-CA) culture.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <UsingTask
    TaskName="Microsoft.Build.Tasks.Windows.FileClassifier"
    AssemblyFile="C:\Program Files\Reference Assemblies\Microsoft\Framework\v3.0\PresentationBuildTasks.dll" />
  <ItemGroup>
    <Resource Include="Resource1.bmp" />
  </ItemGroup>
  <Target Name="FileClassifierTask">
    <FileClassifier
      SourceFiles="Resource1.bmp"
      Culture="fr-CA"
      OutputType="exe" />
  </Target>
</Project>

See also