Compartir a través de

AssignCulture (tarea)

  • Artículo

Esta tarea acepta una lista de elementos que puede contener una cadena de identificador de referencia cultural .NET válida como parte del nombre de archivo y genera elementos que tengan metadatos con el nombre Culture que contiene el correspondiente identificador de referencia cultural. Por ejemplo, el nombre de archivo Form1.fr-fr.resx tiene un indicador de referencia cultural "fr-fr" incluido, por lo que esta tarea genera un elemento que tiene el mismo nombre de archivo con los metadatos Culture igual a fr-fr. La tarea también genera una lista de nombres de archivo con la referencia cultural que se quitó del nombre de archivo.

Parámetros de tareas

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 recibidos en el parámetro Files, con una entrada de metadatos Culture agregada a cada elemento.

Si el elemento entrante del parámetro Files ya contiene una entrada de metadatos Culture, se usa 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 dos últimos puntos en el nombre de archivo.
AssignedFilesWithCulture Parámetro de salida ITaskItem[] opcional.

Contiene el subconjunto de los elementos del parámetro AssignedFiles que tienen una entrada de metadatos Culture.
AssignedFilesWithNoCulture Parámetro de salida ITaskItem[] opcional.

Contiene el subconjunto de los elementos del parámetro AssignedFiles que no tienen una entrada de metadatos Culture.
CultureNeutralAssignedFiles Parámetro de salida ITaskItem[] opcional.

Contiene la misma lista de elementos que se produce en el parámetro AssignedFiles, pero se ha quitado la referencia cultural del nombre de archivo.

La tarea solo 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 incluidos a los que se asignará una referencia cultural. La tarea intenta averiguar si cada archivo es un recurso específico de la referencia cultural y, si es así, qué referencia cultural. Para omitir este proceso de detección y forzar que un archivo sea independiente de la referencia cultural, establezca la entrada de metadatos WithCulture en false.

Comentarios

Además de los parámetros mencionados en este artículo, esta tarea hereda los parámetros de la clase TaskExtension, que a su vez hereda de la clase Task. Para obtener una lista de estos parámetros adicionales y sus descripciones, consulte TaskExtension base class.

Ejemplo

En el siguiente ejemplo se ejecuta la tarea AssignCulture con la recopilación de objetos ResourceFiles.

<Project xmlns="http://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>

En la siguiente tabla se 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 (referencia cultural="fr")

MyResource2.XX.resx (sin metadatos adicionales)
OutAssignedFilesWithCulture MyResource1.fr.resx (referencia cultural="fr")
OutAssignedFilesWithNoCulture MyResource2.XX.resx (sin metadatos adicionales)
OutCultureNeutralAssignedFiles MyResource1.resx (referencia cultural="fr")

MyResource2.XX.resx (sin metadatos adicionales)

Vea también