AssignCulture (Tarea)
Esta tarea admite, como parte de un nombre de archivo, una lista de elementos que puede contener una cadena de identificador de referencia cultural .NET válido. Asimismo, genera elementos con metadatos denominados Culture que contienen el identificador de referencia cultural correspondiente. Por ejemplo, el nombre de archivo Form1.fr-fr.resx tiene un identificador de referencia cultural integrado "fr-fr", por lo que esta tarea generará un elemento con el mismo nombre de archivo y cuyo metadato Culture es igual a fr-fr. La tarea también genera una lista de nombres de archivo cuya referencia cultural se ha quitado del nombre de archivo.
Parámetros de la tarea
En la siguiente tabla se describen los parámetros de la tarea AssignCulture.
Parámetro |
Descripción |
---|---|
AssignedFiles |
Parámetro de salida ITaskItem[] opcional. Contiene la lista de elementos recibida en el parámetro Files, con una entrada de metadatos Culture agregada a cada elemento. Si el elemento de entrada del parámetro Files ya contiene una entrada de metadatos Culture, se utiliza la entrada de metadatos original. La tarea solo asigna una entrada de metadatos Culture si el nombre de archivo contiene un identificador de referencia cultural válido. El identificador de referencia cultural debe estar entre los últimos dos puntos del nombre de archivo. |
AssignedFilesWithCulture |
Parámetro de salida ITaskItem[] opcional. Contiene el subconjunto de los elementos del parámetro AssignedFiles que tiene una entrada de metadatos Culture. |
AssignedFilesWithNoCulture |
Parámetro de salida ITaskItem[] opcional. Contiene el subconjunto de los elementos del parámetro AssignedFiles que no tiene una entrada de metadatos Culture. |
CultureNeutralAssignedFiles |
Parámetro de salida ITaskItem[] opcional. Contiene la misma lista de elementos generados en el parámetro AssignedFiles, excepto que se ha quitado la referencia cultural del nombre de archivo. La tarea sólo quita la referencia cultural del nombre de archivo si es un identificador de referencia cultural válido. |
Files |
Parámetro ITaskItem[] requerido. Especifica la lista de archivos con nombres de referencia cultural incrustados a los que se asignará una referencia cultural. |
Comentarios
Además de los parámetros mencionados anteriormente, esta tarea hereda los parámetros de la clase TaskExtension, que hereda de la clase Task. Para obtener una lista de estos parámetros adicionales y sus descripciones, vea TaskExtension (Clase base).
Ejemplo
En el ejemplo siguiente se ejecuta la tarea AssignCulture con la colección de elementos ResourceFiles.
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<ResourceFiles Include="MyResource1.fr.resx"/>
<ResourceFiles Include="MyResource2.XX.resx"/>
</ItemGroup>
<Target Name="Culture">
<AssignCulture
Files="@(ResourceFiles)"
<Output TaskParameter="AssignedFiles"
ItemName="OutAssignedFiles"/>
<Output TaskParameter="AssignedFilesWithCulture"
ItemName="OutAssignedFilesWithCulture"/>
<Output TaskParameter="AssignedFilesWithNoCulture"
ItemName="OutAssignedFilesWithNoCulture"/>
<Output TaskParameter="CultureNeutralAssignedFiles"
ItemName="OutCultureNeutralAssignedFiles"/>
</AssignCulture>
</Target>
</Project>
La tabla siguiente describe el valor de los elementos de salida después de la ejecución de la tarea. Los metadatos del elemento se muestran entre paréntesis después del elemento.
Colección de elementos |
Contenido |
---|---|
OutAssignedFiles |
MyResource1.fr.resx (Culture="fr") MyResource2.XX.resx (sin metadatos adicionales) |
OutAssignedFilesWithCulture |
MyResource1.fr.resx (Culture="fr") |
OutAssignedFilesWithNoCulture |
MyResource2.XX.resx (sin metadatos adicionales) |
OutCultureNeutralAssignedFiles |
MyResource1.resx (Culture="fr") MyResource2.XX.resx ( (sin metadatos adicionales) |