GenerateResource (Tarea)
Actualización: noviembre 2007
Convierte entre archivos .txt y .resx (formato de recursos basado en XML) y archivos .resources binarios de Common Language Runtime, que se pueden incrustar en un archivo ejecutable binario en tiempo de ejecución o compilar en ensamblados satélite. Esta tarea normalmente se utiliza para convertir archivos .txt o .resx en archivos .resource. La tarea GenerateResource es funcionalmente similar a resgen.exe.
Parámetros
En la siguiente tabla se describen los parámetros de la tarea GenerateResource.
Parámetro |
Descripción |
---|---|
FilesWritten |
Parámetro de salida ITaskItem[] opcional. Contiene los nombres de todos los archivos escritos en el disco. Esto incluye el archivo de la caché, si existe. Este parámetro es útil para las implementaciones de Clean. |
OutputResources |
Parámetro de salida ITaskItem[] opcional. Especifica el nombre de los archivos generados, como los archivos .resources. Si no especifica un nombre, se utiliza el nombre del archivo de entrada coincidente, y el archivo .resources que se crea se coloca en el directorio que contiene el archivo de entrada. |
PublicClass |
Parámetro Boolean opcional. Si true, crea una clase de recurso con nombre seguro como clase pública. |
References |
Parámetro String[] opcional. Hace referencia a tipos de carga en archivos .resx. Los elementos de datos del archivo resx pueden tener un tipo de .NET. Cuando se lee el archivo .resx, se debe resolver esta situación. Normalmente, se resuelve correctamente utilizando reglas de carga de tipo estándar. Si proporciona los ensamblados en References, serán prioritarios. Este parámetro no se requiere para los recursos con tipo seguro. |
Sources |
Parámetro ITaskItem[] requerido. Especifica los elementos que se van a convertir. Los elementos pasados a este parámetro deben tener una de las extensiones de archivo siguientes:
|
StateFile |
Parámetro ITaskItem opcional. Especifica la ruta de acceso a un archivo de la caché opcional que se utiliza para acelerar la comprobación de dependencias de vínculos en archivos de entrada .resx. |
StronglyTypedClassName |
Parámetro String opcional. Especifica el nombre de clase para la clase de recurso con nombre seguro. Si no se especifica este parámetro, se utiliza el nombre base del archivo de recursos. |
StronglyTypedFilename |
Parámetro ITaskItem opcional. Especifica el nombre de archivo para el archivo de código fuente. Si no se especifica este parámetro, el nombre de la clase se utiliza como nombre de archivo base, y la extensión depende del lenguaje. Por ejemplo: MyClass.cs. |
StronglyTypedLanguage |
Parámetro String opcional. Especifica el lenguaje que se utilizará para generar el origen de clase del recurso con nombre seguro. Este parámetro debe coincidir exactamente con uno de los lenguajes utilizado por CodeDomProvider. Por ejemplo: VB o C#. Cuando se pasa un valor a este parámetro, se indica a la tarea que genere recursos con nombre seguro. |
StronglyTypedNamespace |
Parámetro String opcional. Especifica el espacio de nombres que se utilizará para el origen de clase generado para el recurso con nombre seguro. Si no se especifica este parámetro, cualquier recurso con nombre seguro se encontrará en el espacio de nombres global. |
UseSourcePath |
Parámetro Boolean opcional. Si es true, especifica que el directorio del archivo de entrada se utilizará para resolver las rutas de acceso relativas. |
Comentarios
Debido a que los archivos .resx pueden contener vínculos a otros archivos de recurso, no basta con simplemente comparar las marcas de hora de los archivos .resx y .resource para ver si los destinos están actualizados. En su lugar, la tarea GenerateResource sigue los vínculos en los archivos .resx y comprueba también las marcas de hora de los archivos vinculados. Esto significa que, por lo general, no debe utilizar los atributos Inputs y Outputs en el destino que contiene la tarea GenerateResource, puesto que podría causar que se omitiera cuando tendría que ejecutarse.
Ejemplo
El ejemplo siguiente utiliza la tarea GenerateResource para generar archivos .resources de los archivos especificados por la colección de elementos Resx.
<GenerateResource
Sources="@(Resx)"
OutputResources="@(Resx->'$(IntermediateOutputPath)%(Identity).resources')">
<Output
TaskParameter="OutputResources"
ItemName="Resources"/>
</GenerateResource>