AssignCulture, tâche

Mise à jour : novembre 2007

Cette tâche accepte une liste d'éléments qui peuvent contenir une chaîne d'identificateur de culture .NET valide dans leur nom de fichier et génère des éléments possédant une entrée de métadonnées appelée Culture qui contient l'identificateur de culture correspondant. Par exemple, le nom de fichier Form1.fr-fr.resx possède un identificateur de culture incorporé, « fr-fr ». Cette tâche crée dès lors un élément portant le même nom de fichier avec l'entrée de métadonnées Culture correspondant à fr-fr. La tâche génère également une liste de noms de fichiers dont la culture a été supprimée du nom.

Paramètres de la tâche

Le tableau suivant décrit les paramètres de la tâche AssignCulture.

Paramètre	Description
AssignedFiles	Paramètre de sortie ITaskItem[] facultatif. Contient la liste des éléments reçus dans le paramètre Files, avec une entrée de métadonnées Culture ajoutée à chaque élément. Si l'élément entrant du paramètre Files contient déjà une entrée de métadonnées Culture, l'entrée de métadonnées d'origine est utilisée. La tâche assigne uniquement une entrée de métadonnées Culture si le nom de fichier contient un identificateur de culture valide. L'identificateur de culture doit être spécifié entre les deux derniers points du nom de fichier.
AssignedFilesWithCulture	Paramètre de sortie ITaskItem[] facultatif. Contient le sous-ensemble d'éléments du paramètre AssignedFiles qui possèdent une entrée de métadonnées Culture.
AssignedFilesWithNoCulture	Paramètre de sortie ITaskItem[] facultatif. Contient le sous-ensemble d'éléments du paramètre AssignedFiles qui ne possèdent pas d'entrée de métadonnées Culture.
CultureNeutralAssignedFiles	Paramètre de sortie ITaskItem[] facultatif. Contient la même liste d'éléments créés dans le paramètre AssignedFiles, mais dont la culture a été supprimée du nom de fichier. La tâche supprime uniquement la culture du nom de fichier s'il s'agit d'un identificateur de culture valide.
Files	Paramètre ITaskItem[] facultatif. Spécifie la liste des fichiers avec des noms de cultures incorporés auxquels assigner une culture.

Exemple

L'exemple suivant exécute la tâche AssignCulture avec la collection d'éléments 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>

Le tableau suivant décrit la valeur des éléments de sortie après l'exécution de la tâche. Les métadonnées de l'élément sont affichées entre parenthèses après l'élément.

Collection d'éléments	Contenu
OutAssignedFiles	MyResource1.fr.resx (Culture="fr") MyResource2.XX.resx (aucune métadonnée supplémentaire)
OutAssignedFilesWithCulture	MyResource1.fr.resx (Culture="fr")
OutAssignedFilesWithNoCulture	MyResource2.XX.resx (aucune métadonnée supplémentaire)
OutCultureNeutralAssignedFiles	MyResource1.resx (Culture="fr") MyResource2.XX.resx ( (aucune métadonnée supplémentaire)

Voir aussi

Concepts

Tâches MSBuild

Autres ressources

Référence des tâches MSBuild