FileClassifier, tâche

Article
06/09/2015

La tâche FileClassifier classifie un jeu de ressources sources comme celles qui seront incorporées dans un assembly. Si une ressource n'est pas localisable, elle est incorporée dans l'assembly principal de l'application ; sinon, elle est incorporée dans un assembly satellite.

Paramètres de la tâche

Paramètre	Description
CLREmbeddedResource	Non utilisé.
CLRResourceFiles	Non utilisé.
CLRSatelliteEmbeddedResource	Non utilisé.
Culture	Paramètre String facultatif. Spécifie la culture de la génération. Cette valeur peut être null si la génération n'est pas localisable. Si null, la valeur par défaut est la valeur en minuscules que CultureInfo.InvariantCulture retourne.
MainEmbeddedFiles	Paramètre de sortie ITaskItem[] facultatif. Spécifie les ressources incorporées dans l'assembly principal qui ne sont pas localisables.
OutputType	Paramètre String requis. Spécifie le type de fichier dans lequel incorporer les fichiers sources spécifiés. Les valeurs valides sont exe, winexe ou library.
SatelliteEmbeddedFiles	Paramètre de sortie ITaskItem[] facultatif. Spécifie les fichiers localisables incorporés dans l'assembly satellite pour la culture spécifiée par le paramètre Culture.
SourceFiles	Paramètre ITaskItem[] obligatoire. Spécifie la liste des fichiers à classifier.

Notes

Si le paramètre Culture n'est pas défini, toutes les ressources spécifiées à l'aide du paramètre SourceFiles ne sont pas localisables ; sinon, elles sont localisables, sauf si elles sont associées à un attribut Localizable dont la valeur est false.

Exemple

L'exemple suivant classifie un fichier source unique en tant que ressource, puis l'incorpore dans un assembly satellite pour la culture canadienne (France) (fr-CA).

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