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