Partager via

Tâche AssignCulture

  • Article

Cette tâche accepte une liste d’éléments qui peuvent contenir une chaîne d’identificateur de culture .NET valide dans le cadre du nom de fichier et produit des éléments qui ont des métadonnées nommées Culture contenant l’identificateur de culture correspondant. Par exemple, le nom de fichier Form1.fr-fr.resx a un identificateur de culture incorporé «fr-fr», de sorte que cette tâche produit un élément qui a le même nom de fichier avec les métadonnées Culture égales à fr-fr. La tâche produit également une liste de noms de fichiers avec la culture supprimée du nom de fichier.

Paramètres de 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 affecte 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 se trouver entre les deux derniers points du nom de fichier.
AssignedFilesWithCulture Paramètre de sortie ITaskItem[] facultatif.

Contient le sous-ensemble des éléments du paramètre AssignedFiles qui ont une entrée de métadonnées Culture.
AssignedFilesWithNoCulture Paramètre de sortie ITaskItem[] facultatif.

Contient le sous-ensemble des éléments du paramètre AssignedFiles qui n’ont pas d’entrée de métadonnées Culture.
CultureNeutralAssignedFiles Paramètre de sortie ITaskItem[] facultatif.

Contient la même liste d’éléments générés dans le paramètre AssignedFiles, à l’exception de la culture 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[] obligatoire.

Spécifie la liste des fichiers avec des noms de culture incorporés pour affecter une culture. La tâche tente de déterminer si chaque fichier est une ressource spécifique à la culture et, le cas échéant, quelle culture. Pour ignorer ce processus de détection et forcer un fichier à être neutre pour la culture, définissez l’entrée de métadonnées WithCulture sur false.
RespectAlreadyAssignedItemCulture Paramètre bool facultatif.

Si la valeur est true : les métadonnées culture déjà définies sur le paramètre d’élément Files sont respectées et la CultureNeutralAssignedFiles est remplie avec un nom de fichier inchangé de Files.

Remarques

Outre les paramètres répertoriés dans cet article, cette tâche hérite des paramètres de la classe TaskExtension, qui hérite elle-même de la classe Task. Pour obtenir la liste de ces paramètres supplémentaires et de leurs descriptions, consultez classe de base TaskExtension.

Exemple

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

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 d’é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ées supplémentaire)
OutAssignedFilesWithCulture MyResource1.fr.resx (Culture="fr »)
OutAssignedFilesWithNoCulture MyResource2.XX.resx (aucune métadonnées supplémentaire)
OutCultureNeutralAssignedFiles MyResource1.resx (Culture="fr »)

MyResource2.XX.resx (aucune métadonnées supplémentaire)

Voir aussi