FileClassifier Task

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="https://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

Concepts

Building a WPF Application (WPF)

Other Resources

Windows Presentation Foundation MSBuild Reference

Windows Presentation Foundation MSBuild Task Reference

MSBuild Reference

MSBuild Task Reference