Skip to content

resourcesgenerator-task.md

Latest commit

 

History

History
55 lines (46 loc) · 2.31 KB

resourcesgenerator-task.md

File metadata and controls

55 lines (46 loc) · 2.31 KB
title ResourcesGenerator Task
description Learn how MSBuild uses the ResourcesGenerator task to embed one or more resources into a .resources file.
ms.date 11/04/2016
ms.topic reference
dev_langs
VB
CSharp
C++
helpviewer_keywords
embedding resources into a .resources file [WPF MSBuild]
ResourcesGenerator task [WPF MSBuild]
ResourcesGenerator task [WPF MSBuild], parameters
author ghogen
ms.author ghogen
ms.subservice msbuild

ResourcesGenerator task

The xref:Microsoft.Build.Tasks.Windows.ResourcesGenerator task embeds one or more resources (.jpg, .ico, .bmp, XAML in binary format, and other extension types) into a .resources file.

Task parameters

Parameter Description
OutputPath Required String parameter.

Specifies the path of the output directory. If the path isn't an absolute path, it's treated as a path that is relative to the root project directory.
OutputResourcesFile Required ITaskItem[] output parameter.

Specifies the path and name of the generated .resources file. If the path isn't an absolute path, the .resources file is generated relative to the root project directory.
ResourcesFiles Required ITaskItem[] parameter.

Specifies one or more resources to embed in the generated .resources file.

Example

The following example generates a .resources file with a single .bmp resource. The .bmp resource is generated to a directory that is relative to the project root directory.

<Project>
  <UsingTask
    TaskName="Microsoft.Build.Tasks.Windows.ResourcesGenerator"
    AssemblyFile="C:\Program Files\Reference Assemblies\Microsoft\Framework\v3.0\PresentationBuildTasks.dll" />
  <Target Name="ResourcesGeneratorTask">
    <ResourcesGenerator
      ResourceFiles="Resource1.bmp"
      OutputPath="myresources"
      OutputResourcesFile="myresources\my.resources" />
  </Target>
</Project>

See also