Skip to content

fileclassifier-task.md

Latest commit

 

History

History
67 lines (56 loc) · 3.08 KB

fileclassifier-task.md

File metadata and controls

67 lines (56 loc) · 3.08 KB
title FileClassifier Task
description Use the MSBuild FileClassifier task to classify a set of source resources that will be embedded into an assembly.
ms.date 11/04/2016
ms.topic reference
dev_langs
VB
CSharp
C++
helpviewer_keywords
classifying a resource set to embed in an assembly [WPF MSBuild]
non-localizable resources [WPF MSBuild], classifying to embed in an assembly
FileClassifier task [WPF MSBuild]
author ghogen
ms.author ghogen
ms.subservice msbuild

FileClassifier task

The xref:Microsoft.Build.Tasks.Windows.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>
  <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