Tarea AssignCulture

Esta tarea acepta una lista de elementos que pueden contener una cadena de identificador de referencia cultural de .NET válida como parte del nombre de archivo y genera elementos que tienen 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 incrustado "fr-fr", 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 quitada del nombre de archivo.

Parámetros de tarea

En la tabla siguiente se describen los parámetros de la tarea AssignCulture.

Parámetro	Descripción
AssignedFiles	Parámetro de salida opcional ITaskItem[]. Contiene la lista de elementos recibidos en el parámetro Files, con una entrada de metadatos de Culture agregada a cada elemento. Si el elemento entrante del parámetro Files ya contiene una entrada de metadatos de Culture, se usa la entrada de metadatos original. La tarea solo asigna una entrada de metadatos Culture si el nombre del archivo contiene un identificador de referencia cultural válido. El identificador de referencia cultural debe estar entre los dos últimos puntos del nombre de archivo.
AssignedFilesWithCulture	Parámetro de salida opcional ITaskItem[]. Contiene el subconjunto de los elementos del parámetro AssignedFiles que tienen una entrada de metadatos de Culture.
AssignedFilesWithNoCulture	Parámetro de salida opcional ITaskItem[]. Contiene el subconjunto de los elementos del parámetro AssignedFiles que no tienen una entrada de metadatos Culture.
CultureNeutralAssignedFiles	Parámetro de salida opcional ITaskItem[]. Contiene la misma lista de elementos que se generan en el parámetro AssignedFiles, excepto con la referencia cultural quitada 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[] obligatorio. Especifica la lista de archivos con nombres de referencia cultural incrustados a los que 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.
RespectAlreadyAssignedItemCulture	Parámetro de bool opcional. Si se establece en true: se respetan los metadatos de referencia cultural del parámetro Files elemento y el CultureNeutralAssignedFiles se rellenará con un nombre de archivo sin cambios de Files.

Observaciones

Además de los parámetros enumerados en este artículo, 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, consulte clase base TaskExtension.

Ejemplo

En el ejemplo siguiente se ejecuta la tarea AssignCulture con la colección de elementos 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 tabla siguiente 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 Item	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)

Consulte también

• tareas de
• de referencia de tarea