AssignCulture (Tarea)

Actualización: noviembre 2007

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 ha sido eliminada 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 sólo 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 ú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 eliminado la referencia cultural del nombre de archivo. La tarea sólo elimina la referencia cultural del nombre de archivo si es un identificador de referencia cultural válido.
Files	Parámetro ITaskItem[] opcional. Especifica la lista de archivos con nombres de referencia cultural incrustados a los que se asignará una referencia cultural.

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)

Vea también

Conceptos

Tareas de MSBuild

Otros recursos

Referencia de tareas de MSBuild